implement
Skill453 starsChanged 4 months agoApache-2.0View on GitHub
Make the code change a ticket or bug report asks for, then prove it with the repo''s own checks. Use when: told to fix, change or build something, such as "fix this bug".
191 other projects use a version of this.
Adopted by
Most recently taken up by
- revisit-studies/studytheir own version, first seen Nov 9, 2026
- dz114879/skillstheir own version, first seen Nov 8, 2026
- Dimon94/dveritytheir own version, first seen Nov 8, 2026
- Dimon94/skillstheir own version, first seen Nov 8, 2026
- The-Vibe-Company/quivrtheir own version, first seen Nov 8, 2026
- miklschmidt/archboardtheir own version, first seen Nov 8, 2026
Used with
Projects with it also use setup-ts-deep-modules, ask-matt and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
liufeng1976Skillsetup-ts-deep-modules
Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.
Also in 43 projects that use this
GoogleSkillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
Also in 91 projects that use this
RoentekSkillloop-me
Grill me about specs for the workflows I want to build, within this workspace.
Also in 50 projects that use this
AWSSkillto-questionnaire
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
Also in 88 projects that use this
ryotaroh180105Skillclaude-handoff
Hand the current conversation off to a fresh background agent that picks up the work immediately.
Also in 42 projects that use this
GoogleSkillto-spec
Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
Also in 168 projects that use this
- +3 more from google
Other versions191 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 191
- mattpocock/skills★ 309ksame name
- QuivrHQ/quivr★ 40ksame name
- The-Vibe-Company/quivr★ 40ksame name
- foambubble/foam★ 17ksame name
- formbricks/formbricks★ 13ksame name
- ArcReel/ArcReel★ 6.3ksame name
- vinvcn/mattpocock-skills-zh-CN★ 5.5ksame name
- fallow-rs/fallow★ 5.3ksame name
- withcoral/coral★ 4.9ksame name
- bestofjs/bestofjs★ 3.1ksame name
181 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- cli/AGENTS.mdAGENTS.md
- agent-nativeSkill
- agy-nativeSkill
- architectureSkill
- claude-execSkill
- codex-execSkill
- councilSkill
- craft-goalSkill
- docSkill
- domainSkill
- ergonomicsSkill
- idea-genieSkill
- interviewSkill
- memorySkill
- navigateSkill
- orchestrateSkill
- planSkill
- postmortemSkill
- premortemSkill
- refactorSkill
- researchSkill
- reverse-engineerSkill
- reviewSkill
- rpiSkill
- securitySkill
- skill-builderSkill
- skill-evalSkill
- testSkill
- triageSkill
- using-gcSkill
- validateSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 10 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 171 edited versions we read keep these.
10
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 40
Fix the cause, not the oracle: Never loosen an assertion, tolerance, golden, fixture or suppression, or substitute a mock or placeholder, …
- Distinctive: line 47
Find live consumers before editing: Search the callers, readers, scripts, docs and tests of every edited function, type, path, format or …
- Distinctive: line 65
When changing a public failure path, preserve its native failure signal and check that its recovery advice matches any work already …
- Distinctive: line 82
Read intent, acceptance, scope and repository boundaries before the first write.
- Distinctive: line 97
Check a representative change against existing constraints before bulk propagation, and the authored source set before broad regeneration.
- Distinctive: line 104
Read the repository's actual check recipe, including instrumentation and environment, rather than reconstructing it from memory.
- Very specific: line 120
Remove leftovers of abandoned approaches, temporary probes (one shared marker lets a single search prove none remain) and files your checks …
- Distinctive: line 142
Keep full logs at their source.
- Distinctive: line 169
When scaffolding is the requested change, start from the repository's existing layout (or the ecosystem's standard one for a new project) …
- Distinctive: line 175
Prefer current-session execution.
- Distinctive: line 185
When the caller asks for a one-shot adapter (a script or command that sends supplied operations to a tool or runtime), it dispatches each …
“Common” is measured: kept by at least 6 in 10 of the 171 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Implement
Implement the accepted outcome. Repair ordinary known defects directly. Use the
existing intent; a clear edit needs no Plan first. Implement owns source changes
and factual checks. Read changed paths from Git (git status --porcelain,
git diff --name-only <base>), never from memory;
ao provenance manifest --root <repo> with one --include <path> per declared
path digests only the paths you declare and runs no Git. Copy check results from the command output.
Rules that decide the result
- Fix the cause, not the oracle. Never loosen an assertion, tolerance, golden, fixture or suppression, or substitute a mock or placeholder, to turn a check green; nor change what the check runs against: code that acts differently under test or CI, a newly silenced failure path, or a check made non-blocking or skipped. A check that fails against accepted behavior points at a product defect; changing what the check accepts is an acceptance change and needs caller authority.
- Find live consumers before editing. Search the callers, readers, scripts, docs and tests of every edited function, type, path, format or message. For each one, state whether the change affects it and which check covers it. When retiring or renaming, consumers include installations, lookups and old-name invocations; preserve historical provenance. If the replaced interface never merged or shipped and every consumer update fits the scope, update them and delete the old version in the same change, with no alias or shim; otherwise keep the old version working or report it.
- Name discriminating checks. A behavioral change preserves RED for the expected missing behavior: name the check that fails before the edit and passes after (Test's proof rule), plus the check for each affected consumer.
- Report only what ran. Give exact commands and results. List every check you did not or could not run as not run. Never call unrun work verified, fixed or green. Output can show as soon as a command runs, so keep secrets out when you build it: credentials stay in the environment, output that may carry tokens goes to a file, and only redacted excerpts are shown.
When changing a public failure path, preserve its native failure signal and check that its recovery advice matches any work already performed. For uncertain write outcomes or unattended callers, use only the relevant checks in Test's error recovery method.
For an accepted bounded shortcut, review feedback or a defect your change introduced, an authorized commit, history rewrite or merge conflict, dependency upgrade, removal, blocked operation, a decision read from another tool's state or your own uncertain write, use only the matching change safety method. These methods preserve existing authority; they grant no new operation.
For authorized service operations, load only the relevant procedure from operations methods (reliability, delivery, incident recovery, resilience, toil); ordinary edits owe no operations phase.
Workflow
- Read intent, acceptance, scope and repository boundaries before the first write; reuse loaded contracts. RPI boundaries apply when RPI is selected; caller-selected episode tracking follows the session association reference. Note the revision and files already modified, staged or untracked; report only your own as changed, and ask the caller before editing one holding others' edits.
- Carry the accepted behavior examples forward unchanged. Use repository domain names in symbols and tests; check observable outcomes through the relevant interface. Run the smallest applicable check before and after editing. Pure refactors, relocations or docs may have an honest green baseline. Prefer existing tests or small discriminating probes.
- Make the smallest in-scope change. When repairing discovery or checks, preserve the consumer's existing input selection; fixing an error path does not authorize a wider scan. Use a negative control when exclusion matters. Check a representative change against existing constraints before bulk propagation, and the authored source set before broad regeneration. A scripted edit across files first confirms that each anchor matches exactly once; on zero or several matches, write nothing and re-derive it. Repair known failures directly and verify the exact result with a check; a repair does not start another review. A disproved assumption may change the approach within scope; use Plan only for consequential uncertainty.
- Read the repository's actual check recipe, including instrumentation and
environment, rather than reconstructing it from memory. Run targeted tests
and lint/static checks before broad integration, and required full checks at
integration. Reuse exact-input receipts only while source, tool and relevant
environment match. Neither bypass required hooks nor replay a check just to
rename its receipt. A required CI job's known failure is actionable before
the run ends: repair it within scope, keep the failed subject's evidence and
rerun affected checks. Pending jobs do not imply success. A new check, hook
or lint rule counts once the aggregate command or CI runs it (a Git hook needs
an install path;
.git/hooksis not cloned) and it fails on a deliberate violation; else list it undergapsas not wired. Use a local server already on a port only if it provably serves this checkout; stop only processes you started. - Refactor while acceptance remains green. Inspect changed tests, fixtures,
goldens, tolerances, suppressions and specification text against original
intent before handoff. Reread that intent at its source, not a compacted
summary, and check the whole delta against it, untracked files included.
Remove leftovers of abandoned approaches, temporary probes (one shared
marker lets a single search prove none remain) and files your checks made;
list any path you cannot explain under
gapsas a scope amendment. - Have the runtime derive actual changed paths and content identity. A delegated
increment awaiting integration returns an exact commit or runtime-derived
content digests, author context ID and check facts in the existing handoff.
Copy that ID from the session, subagent or thread ID the runtime exposes, or
label a caller-supplied one as supplied; otherwise report it as unknown,
never made up. The integrating caller derives
subject-manifest.v1(AgentOps schema subject-manifest.v1.schema.json, AgentOps source checkout only) over the complete final subject before judgment; an independently judged increment needs its own manifest. Do not generate both merely because work was delegated. Where the repository records AgentOps evidence bindings, also run the advisoryao provenance evidence-orphans --root <repo-root>with one--changed <path>per derived path. Disclose the rows whose cause ischanged_pathorboth(they bind your paths); count the rest undergapsas pre-existing drift, and refresh a binding only when its owner asks. Withoutao, list it undernot run. - Return the handoff below, then stop.
Handoff
Keep full logs at their source; do not duplicate inventories or status documents.
changed: <runtime-derived paths>; identity: <commit or content digests>
author: <runtime session/subagent/thread ID, "ID (supplied)" or "unknown">; when an integrator or fresh read follows
checks: <exact command> -> <result>, one per line; before and after for a behavioral change
not run: <check> -> <reason>; "none" only when every relevant check ran
consumers: <file:line> -> <covering check, or "uncovered">
gaps: <missing or truncated evidence, known failures, scope amendments needed>
cause: <defect repairs only: trigger -> mechanism -> symptom at file:line; sites left as follow-up>Report an uncovered live consumer for a caller scope amendment and continue independent authorized work. Disclose a reversible implementation choice only when its alternative has a material consequence the caller may want to change; name the choice, alternative and reason in the handoff, without a fixed worksheet. Generated companions already included as scope require no new approval; a change to accepted direction, behavior or acceptance always needs caller authority.
Diagnosis, scaffolding and delegated work
For an unexplained failure, follow the diagnosis loop before repairing: confirm the failing run executes the code you think, ground the leading cause in an observation, name its strongest rival and test one prediction the two disagree on. The same file holds the experiments for races, leaked state, hangs, regressions and failures that cross components.
When scaffolding is the requested change, start from the repository's existing layout (or the ecosystem's standard one for a new project) and one working vertical slice; avoid placeholder success paths and a new framework for a one-off operation. For installers, agent-facing tool servers or a Rust CLI with local state, see agent-facing tool scaffolds.
Prefer current-session execution. If delegation is authorized and useful, keep concurrent writers disjoint and isolated as Agent Native describes; shared generators and integration serialize. Supply each lane its intent, acceptance, scope and review owner, then integrate its exact content and check facts. A selected wave ends with the caller-requested wave result; do not invent another wave. One fresh review of the integrated candidate can cover unjudged increments; when the integrator owns that review, workers return their handoff without commissioning another. Preserve any separately required lane judgments; a successful process exit is not semantic PASS.
When the caller asks for a one-shot adapter (a script or command that sends supplied operations to a tool or runtime), it dispatches each operation once, reports its output or error and stops, with no scheduler, retry controller or store; show its dispatch count and failure reporting with a dry-run or fixture. A factory, an external multi-agent system with its own coordinator such as Gas City (Using GC), runs only when the caller selects it.
Finish
Specialists advise only; known defects stay implementation work. A genuine causal stall admits one bounded fresh helper under RPI's stall rule; retries renew no bound.
Return facts, not semantic PASS. An implement-only handoff does not authorize Git, tracker or delivery transitions; existing caller authority remains usable. A full outcome request finishes on its checks and CI; it continues to one fresh independent judgment only on Validate's triggers. Success is working behavior with usable evidence, not volume of logs or process artifacts.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

