jupes/agent-forge-harness / .agents/skills/add-repo
add-repo
VerifiedRegister a repository with Forge, clone it, and configure knowledge and verification commands. Use when adding a sub-repo to the harness.
add-repo
Adds a new sub-repo to the harness: updates local repos/repos.json (gitignored), clones, generates knowledge YAML.
If repos/repos.json is missing, copy repos/repos.json.example to repos/repos.json and edit entries there. Do not commit repos/repos.json.
Steps
1. Resolve location
Accept HTTPS, SSH URL, or local path. Extract repo name from URL (last segment without .git).
2. Check for duplicates
cat repos/repos.json | jq '.repos[] | select(.name == "<repo-name>")'
If already exists: report and stop.
3. Update repos.json
Add: {"name":"<name>","url":"<url>","defaultBranch":"<verified-default-branch>"}
For a dormant or reference-only repository, add "archived": true: it stays registered, and
all-repos runs skip it unless it is named (see the syncing-repos skill, Archived repos).
4. Clone
bun run repo init --repo <repo-name> --human
5. Generate knowledge
/sync-knowledge <repo-name>
6. Give the quality gate the repository's checks
A Forge run that builds in this repository is gated from the harness
(bun run quality-gate --correlation <checkout>/<pointer>). The gate runs the "checks" list on the
repository's entry, in the run's checkout. Each check is a "name" and an "argv": the program,
then its arguments. Discover checks from its manifest, CI, and contribution guide; ask only when those disagree or are absent. Add them to
the entry:
{
"name": "my-service",
"url": "https://github.com/org/my-service.git",
"defaultBranch": "main",
"checks": [
{ "name": "typecheck", "argv": ["bun", "run", "typecheck"] },
{ "name": "lint", "argv": ["bun", "run", "lint"] },
{ "name": "tests", "argv": ["bun", "test"], "timeoutSeconds": 900 }
]
}
- Each check runs without a shell. There is no
&&, no pipe, no$VARand no glob: a check is one program with its arguments. - Windows: a check must name a real executable (an
.exe).npm,pnpm,yarnand other.cmdshims can only be run by cmd.exe, so the gate refuses to run them and the check fails. Namenodeand the tool's script instead, for example["node", "node_modules/typescript/bin/tsc", "--noEmit"], or the tool's own.exe. - A check's name is letters, digits, dot, dash or underscore, and must be unique. It may not be a
check the gate runs itself:
clean-tree,ac-verify,close-testing-attestation,test-evidence,eval-verdictorgate-log. - A check is stopped after two minutes unless it sets its own limit:
"timeoutSeconds", a whole number of seconds from 1 to 3600 (one hour). Set it on a suite that takes longer. A check stopped at its limit fails the gate, and its entry says it was stopped for time ("timedOut": true, and an output that startsstopped after <n> seconds) rather than that it failed. When the gate runs as a hook, the host's own time limit for the hook still applies. - Ignore
.tmp/in the repository, in its.gitignoreor in.git/info/exclude. The harness keeps the run's correlation and verdicts there. If the repository tracks files under.tmp/work/run-correlationsor.tmp/work/evaluations, the gate refuses to run. - If the entry has no
"checks"list, the gate refuses the run and names the entry to fill in.
Completion
The registry names the verified default branch and checks; the clone exists; knowledge generation succeeded or its failure is reported. Re-read the registry and report the resolved checkout.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |