Skip to content

feat: add agent-ready and init-agents-md skills#42

Open
johnmcollier wants to merge 1 commit into
redhat-developer:mainfrom
johnmcollier:agent-ready-skill
Open

feat: add agent-ready and init-agents-md skills#42
johnmcollier wants to merge 1 commit into
redhat-developer:mainfrom
johnmcollier:agent-ready-skill

Conversation

@johnmcollier
Copy link
Copy Markdown
Member

@johnmcollier johnmcollier commented Jun 4, 2026

Summary

  • Adds agent-ready skill: runs the agentready CLI against a git repository, parses the assessment JSON, and walks through failing findings in tier order. Supports auto mode (apply deterministic fixes, prompt on ambiguous cases) and review mode (yes/skip/defer/quit per finding). Delegates AGENTS.md creation to init-agents-md. Skips ADR and design intent findings in auto mode to avoid fabricating rationale; prompts for human input in review mode.
  • Adds init-agents-md skill: bootstraps AGENTS.md and CLAUDE.md for any repository by scanning config files and CI for commands, asking three targeted questions, and writing a minimal draft for human review.
  • Updates README with a new Repository Readiness section covering both skills.

Test plan

  • Run agent-ready on a repo with low agentready score, verify findings are presented in tier order
  • Verify agent_instructions finding delegates to init-agents-md
  • Run init-agents-md standalone on a fresh repo, verify AGENTS.md and CLAUDE.md are written

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
@johnmcollier johnmcollier changed the title [WIP] feat: add agent-ready and init-agents-md skills feat: add agent-ready and init-agents-md skills Jun 4, 2026
@johnmcollier johnmcollier marked this pull request as ready for review June 4, 2026 15:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant