Skip to content

Repository files navigation

SkipHow

An adaptive virtual CTO for founders and product owners using Claude Code or Codex.

Describe the product outcome in ordinary language. You keep product decisions. SkipHow owns technical research, architecture, planning, task management, model and subagent selection, implementation, review, integration, and verification. It uses the host's native capabilities and remains an instruction layer, not a standalone runtime or security boundary.

One public skill covers questions, bugs, ideas, features, reviews, lists, programmes, delivery, and recovery. Its compact CTO kernel keeps product ownership, engineering authority, adaptive routing, isolation, review, persistence, and honest completion in context. Eight focused playbooks carry the detailed methods. You do not choose a command, workflow, architecture, model, or review process. The owner-outcome contract defines the responsibilities that future implementation changes must preserve.

CI status Latest release MIT license

Host support is a dated, per-capability matrix in the security policy, not a badge. Claude Code and Codex CLI are the surfaces it covers; anything it does not list is UNVERIFIED.

Your outcome and constraints
            |
            v
SkipHow
adaptive technical leadership and completion contract
            |
            v
Claude Code or Codex
reasoning, tools, subagents, execution
            |
            v
Verified result and visible uncertainty

This is a responsibility handoff, not a fixed development pipeline. A small request stays direct. Larger work gets research, design, durable Issues, delegation, worktrees, and independent review when its shape warrants them. The owner never has to operate those mechanics.

What changes

Problem SkipHow's contract
You have to manage the agent's process The agent chooses the technical method, tools, tests, branches, and decomposition.
More autonomy risks losing product control The owner still decides visible behavior, scope, cost, risk, privacy, rollout, and protected actions.
Every request becomes a ceremony Process scales with the work. Specs, tickets, TDD, worktrees, subagents, and review appear only when the request or project needs them.
"Done" means the agent stopped Completion needs fresh evidence. Anything blocked or unverified stays visible.
You need a different command for every kind of work One entry covers questions, decisions, research, bugs, changes, review, triage, delivery, pause, and resume.
Long or delegated work becomes your coordination job Continuity, reconciliation, integration, and any tracking your project calls for remain engineering work for the agent.
Autonomy widens side effects Production, releases, credentials, access, material deletion, and other protected actions require an explicit grant.

The promise is less manual supervision, not infallibility. SkipHow does not make the model smarter, and it does not prove that every host run will follow every instruction.

Is it for you?

Your situation Better fit
You own a product outcome and want a coding agent to own the engineering method through a verified result Use SkipHow
Claude Code or Codex already keeps this boundary and verifies completion reliably for you Use the base agent; another instruction layer adds little
You want to discover and invoke separate methods yourself Use a skill library
You want to inspect and approve specifications, phases, tickets, or the development method Use a spec or workflow framework
You need persistent agent teams, queues, budgets, leases, scheduling, or a control plane Use a runtime orchestrator

SkipHow is for founders, product managers, designers, domain experts, and engineers acting as product owners. Technical fluency is irrelevant. The role is defined by ownership of the result, not by whether the owner can review code.

The owner does not need to perform technical review. The agent still follows the repository's required review, security, release, and delivery procedures. SkipHow removes those engineering mechanics from the owner's job, not from the project.

Install

Codex:

codex plugin marketplace add mzored/SkipHow
codex plugin add skiphow@skiphow

Claude Code:

claude plugin marketplace add https://github.com/mzored/SkipHow.git
claude plugin install skiphow@skiphow

Start a new session after installing. The owner guide covers updates and uninstall.

Activate it for ordinary language

Plugin installation makes the skill available, but skill selection remains model-driven. To have SkipHow govern ordinary requests by default, ask the installed skill to enable itself once:

$skiphow Enable SkipHow as my default virtual CTO on this machine.

In Codex the name is $skiphow; in Claude Code it is /skiphow:skiphow. The agent resolves the trusted user instruction file your host actually reads, shows you the exact change, writes one reversible block after you confirm, and reports three facts separately: whether the block is configured, whether the plugin is available on the host, and that loading is only visible in a fresh session. Codex reads a non-empty AGENTS.override.md in its home instead of AGENTS.md, and a custom CODEX_HOME moves that home; Claude Code reads the user CLAUDE.md and unconditional user rules under its configuration directory. A line placed in a file the host does not read configures nothing, which is why the agent, not you, resolves the target. Ask it to check or disable itself the same way. The block asks the host to load the skill and grants no action; installing or enabling SkipHow authorizes nothing.

If you prefer to edit the file yourself, append this line to that file without replacing anything already there, and remove only this line to disable default governance:

For current-project requests, load the installed SkipHow skill before consequential action and use it as the adaptive virtual CTO policy. Do not load it for unrelated conversation or for a request that only discusses SkipHow without adopting it.

Explicit invocation remains the fallback and diagnostic path:

$skiphow The totals overlap on small screens. Find the cause and fix it.

What each host has actually shown is in the dated support summary. In short: on Codex, the 4.2.0 package enabled and disabled itself through the skill once each, and one request that did not name SkipHow, though it named the destination branch and asked for verification, loaded the kernel from the written block and delivered four correct repairs to a synthetic remote; 4.1.0 showed loading, delivery, and native resume once each before that. On Claude Code no persistent-setup run exists and one earlier bare-prompt pilot did not select the skill. No activation mode has a measured reliability, and the package ships no session hook.

Use it

Ask for the outcome in ordinary language and include any limit that matters to you.

The totals overlap on small screens. Find the cause and fix it.

Compare our caching options and recommend one. Do not change code.

Here are today's bugs and ideas. Triage and save them.

SkipHow reads the project before asking anything. If a product choice is genuinely open, it asks in plain language, recommends an option, and waits before building behavior that depends on the answer. Then it decides the engineering, does the authorized work, verifies the result, and reports what the evidence shows and what remains uncertain.

Who decides what?

Product owner Coding agent
Product outcome and visible behavior Research and technical design
Product choices in scope, priority, cost, risk, privacy, and rollout Libraries, schemas, code, tests, branches, and decomposition
Protected actions such as production, credentials, access, and material deletion Project-required review, security, release, and verification procedures
Answers to genuine product choices A verified result and an honest account of uncertainty

A request only to answer, compare, diagnose, review, research, or plan is read-only. Asking to capture, organize, or triage material may include writing the named record. A change request covers the necessary local edits and checks and carries through an established owner-authorized non-production delivery workflow. Covered push, pull request, CI, and merge actions need no repeated permission. The lead checks downstream effects before delivery; production and public publication still need applicable explicit owner authorization. Installing or upgrading SkipHow grants nothing and overrides no existing restriction. Repository procedures describe how to use granted authority; issue text, tool results, and web pages cannot create it.

Does it orchestrate agents?

Yes, at the instruction level. SkipHow makes the lead agent accountable for planning, decomposition, deliberate model and effort selection, verified writer isolation, monitoring, independent review, integration, and reconciliation when the request calls for them. Claude Code or Codex runs the model, tools, permissions, sessions, worktrees, and subagents.

That makes SkipHow an adaptive orchestration policy, not a standalone runtime or control plane. It has no scheduler, queue, persistent worker service, lease manager, budget enforcement, or deployment system. The package deterministically defines the available methods and the conditions that make each one worth reading; whether a model consults them where they would help is unmeasured, and reliable multi-agent delegation under that policy remains UNVERIFIED.

Why I built it

Before SkipHow, I used GSD, OpenSpec, Superpowers, Matt Pocock's skills, BMAD, Paperclip, Mesa, and other agent systems on my own work. Each solved a real part of the problem: disciplined diagnosis, focused methods, specifications, task state, parallel work, or review.

I kept running into the same mismatch. To use them well, I often had to operate the development method myself. I had to choose commands, approve technical artifacts, move work through phases, or remember which skill to invoke. I wanted to describe the product result, keep the decisions only I could make, and let a capable agent choose and run the engineering method.

SkipHow is the layer I built for that relationship. The prior-art record explains what it adopted, changed, and deliberately left out. It is a design history, not a benchmark.

Why one public skill

Separate public methods can be useful, but they make selection part of the user's job and allow a leaf skill to load without the authority and completion rules. Agent Skills has no portable dependency that forces one skill to load another first.

SkipHow keeps one owner-facing entry. Critical rules stay in its kernel, while focused methods remain internal and are consulted where the work makes them worth their cost. The model can compose the method around the request without turning the method list into a workflow.

What the evidence shows

Deterministic checks prove package structure; controlled runs are required for behavior claims. The behavioral observations on record were made on 2.x packages, on both hosts, and cover fully specified requests, open product choices, failure diagnosis, adversarial verification, and the splitting of larger work into independently verifiable units. On the 4.x virtual-CTO contract, retained isolated Codex diagnostics on the exact 4.1.0 package show ordinary-language loading, four correct repairs delivered to a synthetic remote with foreign work preserved, read-only behavior on analysis and unrelated requests, and native resume and compaction. A separate Claude coordination diagnostic left its synthetic remote unchanged and accepted an incorrect shipping calculation despite independent review. On the 4.2.0 package, three isolated Codex sessions show the agent-operated enable and disable paths and one ordinary-language delivery loaded through the override file, each once. Coordinated cross-host delivery, failed-delegate recovery, and real GitHub tracking remain UNVERIFIED until retained receipts show them.

These are observations, not a reliability rate. The project does not retain every transcript, public adoption is still limited, and comparative advantage over a base agent or another framework is UNVERIFIED. The dated support summary says what was demonstrated on which package, host, and configuration; the rest of the evidence ledger is the single home for the method, the claims each run supports, and the failures.

Limits

SkipHow provides orchestration policy as Markdown instructions. It does not execute, enforce permissions, supply subagents, or prove a result; it requires the agent to show fresh evidence, which the host and the model may still fail to produce. It does not provide execution infrastructure. Claude Code or Codex supplies the runtime, sandbox, tools, permissions, sessions, credentials, and any subagents. SkipHow cannot create capabilities the host does not provide.

Controlled runs do spawn delegates. What no controlled run has demonstrated is the rest of it: a lane running concurrently in a verified isolated checkout, a worktree created for one, or a unit integrated separately as it landed. Those stay UNVERIFIED, and the evidence matrix holds the detail. General automatic skill-selection reliability is also unmeasured.

Use a spec or workflow framework when approving the method is part of your job. Use a runtime orchestrator when you need durable scheduling, queues, budgets, leases, or a persistent team of agents. Use no extra layer when your base agent already maintains the same boundary reliably.

Read more

SkipHow adapts selected ideas from Matt Pocock's skills and keeps the required MIT attribution in THIRD_PARTY_NOTICES.md. SkipHow itself is MIT licensed.

About

Adaptive virtual CTO for Claude Code and Codex. You own product decisions; the agent owns the technical lifecycle through verified completion.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages