{
  "markdown": "# keel-skill\n\n`keel-skill` packages the Keel workflow as:\n\n- A reusable agent skill: [`skills/keel-workflow`](skills/keel-workflow)\n- A Claude Code plugin: [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)\n- A Gemini CLI extension: [`gemini-extension.json`](gemini-extension.json)\n- Shared harness context files: [`AGENTS.md`](AGENTS.md), [`CLAUDE.md`](CLAUDE.md), and [`GEMINI.md`](GEMINI.md)\n\nThe source workflow came from `~/workspace/rupurt/keel/AGENTS.md` and is now split into:\n\n- A shared harness-level workflow file in [`AGENTS.md`](AGENTS.md)\n- A concise reusable skill in [`skills/keel-workflow/SKILL.md`](skills/keel-workflow/SKILL.md)\n- Namespaced plugin commands in [`commands/keel`](commands/keel)\n\n## What You Get\n\n- `keel-workflow` skill for planning, implementation, and research tasks in Keel-managed repositories\n- `/keel:implement`, `/keel:plan`, and `/keel:research` commands for Claude Code and Gemini CLI\n- Importable `AGENTS.md` instructions for repos that want shared harness context instead of a global install\n\n## Install\n\n### Codex\n\nFrom the repo root, install the skill directly into your Codex skills directory:\n\n```bash\nmkdir -p ~/.codex/skills\nln -s \"$(pwd)/skills/keel-workflow\" ~/.codex/skills/keel-workflow\n```\n\nIf you want workspace-scoped installation for tools that support the generic agent-skills alias, symlink the same folder into `.agents/skills/keel-workflow` inside the target repository instead.\n\n### Claude Code\n\nFrom the parent directory of this repo, create a small local marketplace that points at this plugin:\n\n```bash\nmkdir -p ../dev-marketplace/.claude-plugin\ncat > ../dev-marketplace/.claude-plugin/marketplace.json <<'EOF'\n{\n  \"name\": \"local-keel\",\n  \"plugins\": [\n    {\n      \"name\": \"keel-skill\",\n      \"source\": \"../keel-skill\",\n      \"description\": \"Keel workflow plugin\"\n    }\n  ]\n}\nEOF\n```\n\nStart Claude Code from the parent directory, add the marketplace, and install the plugin:\n\n```text\n/plugin marketplace add ./dev-marketplace\n/plugin install keel-skill@local-keel\n```\n\nFor published installs, point `/plugin install` at the marketplace entry that serves this repo.\n\n### Gemini CLI\n\nFrom the repo root, install the full extension:\n\n```bash\ngemini extensions link .\n```\n\nYou can also install from a Git repository:\n\n```bash\ngemini extensions install https://github.com/your-org/keel-skill\n```\n\nIf you only want the reusable skill instead of the full extension:\n\n```bash\ngemini skills install \"$(pwd)/skills/keel-workflow\"\n```\n\n## Usage\n\n### Codex\n\nThe skill auto-triggers when the task is clearly about Keel workflow operations such as planning a voyage, implementing a story, or running bearing research. You can also mention the skill explicitly:\n\n```text\nUse the keel-workflow skill to plan the next voyage.\nUse the keel-workflow skill to implement the next story with TDD.\nUse the keel-workflow skill to research this ambiguous feature area.\n```\n\n### Claude Code\n\nAfter installation, use the bundled namespaced commands:\n\n```text\n/keel:implement STORY-123\n/keel:plan \"Plan the auth hardening voyage\"\n/keel:research \"Explore API versioning strategy\"\n```\n\nThe bundled `keel-workflow` skill is also available for automatic invocation when the task matches.\n\n### Gemini CLI\n\nAfter linking or installing the extension, use the same namespaced commands:\n\n```text\n/keel:implement STORY-123\n/keel:plan \"Plan the auth hardening voyage\"\n/keel:research \"Explore API versioning strategy\"\n```\n\nGemini also loads [`GEMINI.md`](GEMINI.md) at session start and can invoke the bundled `keel-workflow` skill automatically.\n\n## Repo Layout\n\n```text\n.\n├── AGENTS.md\n├── CLAUDE.md\n├── GEMINI.md\n├── .claude-plugin/plugin.json\n├── gemini-extension.json\n├── commands/keel/\n└── skills/keel-workflow/\n```\n\n## Official References\n\n- OpenAI Codex agent skills: https://developers.openai.com/codex/guides/skills\n- Claude Code plugins: https://docs.claude.com/en/docs/claude-code/plugins\n- Gemini CLI skills: https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/skills.md\n- Gemini CLI extensions: https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md\n",
  "bytes": 4134,
  "sha": "5e383188ad8a009d106a23f24375982401cdae9f4d7b6d4fbd239ecad7f4f5da",
  "repo_slug": "rupurt/keel-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_rupurt_keel_skill_ee17c6ec/readme"
}