{
 "schema_version": 1,
 "generated": "2026-10-26",
 "id": "birfy-agentdescent--improve-an-agent-skill-from-claude-code",
 "repo": "Birfy/agentdescent",
 "repo_url": "https://github.com/Birfy/agentdescent",
 "repo_slug": "birfy-agentdescent",
 "title": "Improve an agent skill from inside Claude Code",
 "page_title": "How to improve an agent skill from inside Claude Code with Agentdescent",
 "summary": "Ask Claude Code or Codex to evolve a skill, with a quoted cost before any run starts.",
 "who": "A developer who maintains a shared skill or prompt for Claude Code or Codex and wants it tuned against examples without leaving the agent.",
 "problem": "Iterating on a skill file by hand inside an agent means guessing, rerunning, and losing track of what changed.",
 "outcome": "A detached evolution run, status checks from the agent, and an evolved skill that is written back only after you approve.",
 "steps": [
  "`git clone https://github.com/Birfy/agentdescent && cd agentdescent`",
  "`bash scripts/setup-hosts.sh`",
  "`agentdescent doctor`",
  "In the agent, say \"improve this prompt against these examples\" and point it at your example file.",
  "Review the call count it quotes, approve the run, then approve or reject the write-back."
 ],
 "agent_prompt": "Clone https://github.com/Birfy/agentdescent, run `bash scripts/setup-hosts.sh`, then ask the agent to improve <path to skill or prompt file> against <path to examples file>. Expected output: a call count, a status report, and a proposed evolved version. Verify that nothing is written back to the target file until the user confirms.",
 "agents": [
  "claude-code",
  "codex"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The plugin setup is documented from the current main checkout, so the install path may differ from the PyPI release.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "Python 3.9 or newer",
  "pip to install the agentdescent package from PyPI",
  "For model-backed runs: an OpenAI-compatible endpoint, its base URL, and an API key set in environment variables (OPENAI_BASE_URL and OPENAI_API_KEY)",
  "For agent-plugin use: Claude Code or Codex installed, and git to clone the repo"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "The run needs your model key in the environment, and the agent setup wires into whichever CLIs you have installed."
  }
 ],
 "best": false,
 "score": 0.8,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/birfy-agentdescent/improve-an-agent-skill-from-claude-code/",
 "md": "https://dedupedai.com/use-cases/birfy-agentdescent/improve-an-agent-skill-from-claude-code/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/birfy-agentdescent--improve-an-agent-skill-from-claude-code.json",
 "api_version": "v1"
}