akunzai/agent-skills / skills/setup-agent-ready-repo
setup-agent-ready-repo
UnverifiedSet up a repository so agents can file tickets, open pull or merge requests, and verify their own changes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.1 KB |
| agents/openai.yaml | config | 172 B |
| assets/guarantees.tsv | other | 3.7 KB |
| assets/templates/issue-tracker.md | markdown | 5.8 KB |
| assets/templates/pull-request.md | markdown | 4.9 KB |
| assets/templates/verification.md | markdown | 5.2 KB |
| references/capture.md | markdown | 4.9 KB |
| references/gitlab-cli.md | markdown | 2.1 KB |
| references/re-running.md | markdown | 2.1 KB |
| references/ticket-and-pr.md | markdown | 7.4 KB |
| references/verification.md | markdown | 8.0 KB |
| scripts/check-drift.shexecutable | script | 7.7 KB |
| scripts/install-templates.shexecutable | script | 7.2 KB |
| skill.oms.sig | other | 14.6 KB |
assets/guarantees.tsv
View on GitHub# Guarantees the templates pin, one per line, read by both consumers:
# skills/setup-agent-ready-repo/scripts/install-templates.sh --check
# evals/setup-agent-ready-repo/graders/documents.sh
#
# Tab-separated. TSV rather than JSON because --check runs in whatever repo the
# skill was pointed at, where jq is not guaranteed to exist.
#
# document the installed file: issue-tracker, request (pull-request.md or
# merge-request.md, whichever the forge got), or verification
# name what a developer reads when it is missing
# pattern case-insensitive extended regex, matched against the whole file
# origin where in the template it comes from, so an agent can read the
# original and adapt it to this repo
#
# A guarantee belongs here when the template pins it for every repo. A fact
# that varies by forge, by task, or by the language answer stays in the grader,
# which knows what it asked for. A section the template tells some repos to
# delete is not pinned for every repo either: a library with no stack deletes
# the deployed-verification path, and a repo with no human-only step deletes
# its prerequisites, so neither can be required here.
#
# A pattern decides that a document addresses the guarantee, never that it
# addresses it correctly: a one-word pattern matches a sentence that says the
# opposite just as readily. That judgement is the reviewer's, the same bound
# check-drift.sh states for the facts a script can decide. Prefer a phrase over
# a word, and one that survives being reworded for another repo.
#
# document name pattern origin
issue-tracker the language tickets are written in write [^.]*(titles|descriptions) issue-tracker.md, opening paragraph
issue-tracker the CLI conventions for issue operations issue (create|view|list) issue-tracker.md, Conventions
issue-tracker the collapsed technical section <details> issue-tracker.md, Description shape
issue-tracker the shape of an issue an agent implements from acceptance criteria issue-tracker.md, Spec issues
issue-tracker the rule against personally identifiable information personally identifiable|\bPII\b issue-tracker.md, below Description shape
request the language requests are written in write [^.]*(titles|descriptions) pull-request.md, opening paragraph
request commit messages staying English commit[^.]*english|english[^.]*commit pull-request.md, opening paragraph
request which diagram belongs to which change mermaid|flowchart|sequencediagram|erdiagram pull-request.md, Description shape
request the rule against personally identifiable information personally identifiable|\bPII\b pull-request.md, Description shape
request the paths exempt from landing with tests exempt|excluded pull-request.md, Tests land with the behaviour
request that a request is opened only when asked for only when asked|developer ask pull-request.md, Preparing
request the CLI that opens and updates requests (gh pr|glab mr) (create|edit|update) pull-request.md, Preparing
verification the entrypoint marker check-drift.sh reads drift:entrypoint verification.md, Starting the environment
verification the forge marker check-drift.sh reads drift:forge verification.md, Starting the environment
verification the proof that the entrypoint came up [*][*]proof verification.md, Starting the environment
verification what could not be verified, and why not verified|unverified|could not be verified verification.md, Not verified
verification that a gap you could have closed is not a gap could have closed|already seen running verification.md, Not verified
verification the capture rules the request document points at capture rules|capturing evidence verification.md, Capturing evidence
verification the UI locale captures are taken in ui locale verification.md, Capturing evidence
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |