feat: add agent-ready and init-agents-md skills#42
Open
johnmcollier wants to merge 1 commit into
Open
Conversation
Adds two general-purpose repository readiness skills: - agent-ready: runs the agentready CLI, parses the assessment JSON, and walks through failing findings in tier order. Supports auto mode (apply deterministic fixes, prompt on ambiguous), review mode (yes/skip/defer/quit per finding), and delegates AGENTS.md creation to init-agents-md. Skips ADRs and design intent in auto mode to avoid fabricating rationale. - init-agents-md: bootstraps AGENTS.md and CLAUDE.md from repo inspection. Detects build/test/lint commands from config files and CI, asks three targeted questions, and writes a minimal draft for human review. Assisted-by: Claude Sonnet 4.6
4ca79a8 to
3172988
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
automode (apply deterministic fixes, prompt on ambiguous cases) andreviewmode (yes/skip/defer/quit per finding). Delegates AGENTS.md creation toinit-agents-md. Skips ADR and design intent findings in auto mode to avoid fabricating rationale; prompts for human input in review mode.AGENTS.mdandCLAUDE.mdfor any repository by scanning config files and CI for commands, asking three targeted questions, and writing a minimal draft for human review.Test plan
agent-readyon a repo with low agentready score, verify findings are presented in tier orderagent_instructionsfinding delegates toinit-agents-mdinit-agents-mdstandalone on a fresh repo, verify AGENTS.md and CLAUDE.md are written