Ra1 fix

Skill tjboudreaux/ready-agent-1/skills/ra1-fix

Ready Agent 1 — is your codebase ready for the agents? Score agent-readiness (deterministic, cited, Level 1-5) and clear the gates.

Install

npx -y skills add tjboudreaux/ready-agent-1 --skill ra1-fix

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Ready Agent 1 gears up your repo (the Loadout) — remediate agent-readiness gaps by applying safe configuration scaffolds, drafting documentation for review, and listing GitHub settings to change. Use when the user asks to fix readiness, remediate readiness findings, raise the readiness level, apply readiness fixes, or scaffold missing config (linters, CI, CODEOWNERS, issue/PR templates, dependabot, devcontainer, .env.example). Applies changes to a local branch only and never pushes without confirmation.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.9 KB, as published. Nobody here has run it

Agent Readiness Fix

Raise a repo's readiness by applying only safe changes. The engine plans and writes config scaffolds; you handle git and author any prose. Three buckets, three different safety levels.

Steps

Resolve the latest report. Mirroring Droid's /readiness-fix, resolve the latest stored report by repository identity from the local history; run the ra1-report skill first if none exists.
Dry-run the plan to see what would change:
```
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --latest
```
It prints Auto-apply (safe config scaffolds — includes registry-declared autofixable scaffolds even when advisory), Propose (drafts for review), GitHub settings (manual), plus a Verify reminder. Focus the plan deterministically:
- --include <id>... / --exclude <id>... are authoritative criterion-id filters;
- --instructions "prioritize security" / "do not touch CI" use a small keyword→pillar grammar; any phrase outside the grammar is annotated as a Note and never silently filters. Non-scaffold advisory/prose work is only planned when explicitly --included.
Create a local branch first (never work on the default branch):
```
git -C <repo-path> checkout -b readiness/fixes
```
Apply the safe scaffolds (idempotent; refuses on a dirty worktree; never overwrites non-empty files):
```
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --latest --apply
```
Author the "Propose" items yourself — README sections, a tailored AGENTS.md, runbooks, a first test. Write these as drafts for the user to review; do not invent facts about the codebase. templates/AGENTS.md is a starting skeleton — fill it from what the repo actually does.
- When the Propose list contains docs.agent_verify_contract, draft the workflow section from templates/acdc/workflow.md. Fill <VERIFY_COMMAND> in this order: acdc.verify_command, build.check_command evidence, then the documented test command. Fill <GUIDE_DOCS> only from architecture docs actually identified in the report. Offer templates/acdc/guide-skill.md, verify-skill.md, and solve-skill.md as optional additions under the repo's skills directory. Treat the workflow and skills as drafts for review; never auto-apply them.
Show the diff and commit locally. Summarize changes, then:
```
git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"
```
End the commit message with the required Co-Authored-By trailer.
Re-run ra1-report to show the level delta.

Contract (do not violate)

Never push and never open a PR without explicit user confirmation. Build and commit locally first.
Auto-apply config scaffolds only. README/AGENTS.md/tests/runbooks are proposed drafts the user reviews — auto-writing prose risks "documenting fiction."
Never bundle GitHub setting changes (branch protection, secret scanning, labels) with code commits. Present them as a checklist of gh commands for the user to run and confirm.
Respect a dirty worktree: do not --force over uncommitted work without asking.