{
  "markdown": "# Rails Agent Skills\n\nA catalog of **28 Rails skills** and **9 personas** that teach agents how to test, implement, and review Rails work. Process skills (TDD gates, YARD, DDD, service objects) live in [`ruby-core-skills`](https://github.com/igmarin/ruby-core-skills). Install both.\n\n```text\nWrite the test → run it → confirm it fails for the right reason → implement → confirm it passes\n```\n\n```mermaid\nflowchart TB\n  subgraph thisRepo[rails-agent-skills]\n    atomics[28 atomics]\n    personas[9 personas]\n  end\n  core[ruby-core-skills]\n  thisRepo --> core\n```\n\nAlso in the same ecosystem: [`hanakai-yaku`](https://github.com/igmarin/hanakai-yaku), [`agnostic-planning-skills`](https://github.com/igmarin/agnostic-planning-skills), [`agent-mcp-runtime`](https://github.com/igmarin/agent-mcp-runtime), [`ruby-skill-bench`](https://github.com/igmarin/ruby-skill-bench).\n\n## Daily loop\n\n```mermaid\nflowchart LR\n  A[Task] --> B[load-context]\n  B --> C[plan-tests]\n  C --> D[write-tests RED]\n  D --> E[implement GREEN]\n  E --> F[docs + review]\n  F --> G[PR]\n```\n\nName the persona when you want the whole chain: `tdd`, `bug-fix`, `graphql`, `migration`, `background-job`, `engine`, `review`, `quality`, `setup`.\n\nSee [docs/persona-guide.md](docs/persona-guide.md) and [docs/personas/](docs/personas/).\n\n## Catalog\n\n| Area | Skills |\n|------|--------|\n| Testing | `plan-tests`, `write-tests`, `test-service` |\n| Quality | `code-review`, `security-check`, `review-architecture`, `apply-code-conventions`, `apply-stack-conventions`, `implement-authorization`, `refactor-code` |\n| Engines | `create-engine`, `test-engine`, `document-engine`, `review-engine`, `release-engine`, `create-engine-installer`, `extract-engine`, `upgrade-engine` |\n| Infrastructure | `review-migration`, `implement-background-job`, `seed-database`, `optimize-performance`, `version-api`, `implement-hotwire` |\n| API | `generate-api-collection`, `implement-graphql` |\n| Context | `load-context`, `setup-environment` |\n\nCore skills (install separately): `triage-bug`, `respond-to-review`, `write-yard-docs`, `create-service-object`, `integrate-api-client`, `define-domain-language`, `model-domain`, `skill-router`, and the process skills.\n\nFull list: [docs/reference/skill-catalog.md](docs/reference/skill-catalog.md). Gaps: [docs/reference/gaps.md](docs/reference/gaps.md).\n\n## Install\n\nThere is **no** root `SKILL.md`. Each folder under `skills/` is its own skill, so the CLI can prompt for **all** or **one**.\n\n```bash\n# picker: all skills, or a subset\nnpx skills add igmarin/ruby-core-skills\nnpx skills add igmarin/rails-agent-skills\n\n# all skills, skip prompts\nnpx skills add igmarin/ruby-core-skills --skill '*'\nnpx skills add igmarin/rails-agent-skills --skill '*'\n\n# one skill\nnpx skills add igmarin/rails-agent-skills --skill load-context\n```\n\nOr with GitHub CLI v2.90.0+ (`gh skill`):\n\n```bash\ngh skill install igmarin/ruby-core-skills\ngh skill install igmarin/rails-agent-skills\ngh skill install igmarin/rails-agent-skills code-review --scope project\n```\n\nA PromptScript global-install warning from `skills.sh` is harmless. The skills still install for other hosts.\n\n## Docs\n\n| Need | Document |\n|------|----------|\n| Host context | [AGENTS.md](AGENTS.md) |\n| How to invoke a persona | [docs/persona-guide.md](docs/persona-guide.md) |\n| Skill layout | [docs/architecture.md](docs/architecture.md) |\n| Eval ownership | [docs/eval-provenance.md](docs/eval-provenance.md) |\n\n## Contributing\n\n- Artifacts in English unless the user asks otherwise.\n- Keep the tests-gate rule on every code-producing skill.\n- `description` is when + triggers (≤ 600 chars). Procedure stays in the body.\n- Keep public docs in sync with `directory.json`.\n\nThanks to [Mumo Carlos (@mumoc)](https://github.com/mumoc).\n",
  "bytes": 3767,
  "sha": "969044fff77181a0d8a9b01985b018dee49c173522dbf71b758dd2d995f10a78",
  "repo_slug": "igmarin/rails-agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_igmarin_rails_agent_skills_mcp_a806f6f5/readme"
}