{
  "markdown": "# improve-this\n\n## Description\n\nA skill that evaluates any project — code, docs, prompts, or otherwise — for potential improvements. Propose which categories to evaluate, review the findings, and optionally generate a phased implementation plan for the issues you care about.\n\nRun it with different AI models (or newly-released models) to surface different improvement perspectives on prior work. The skill is strictly evaluate-and-report — it never modifies files.\n\n## Usage\n\n```\n/improve-this                      # Review the full project\n/improve-this src/components       # Scope to a directory\n/improve-this search               # Scope to a topic\n```\n\nThe skill will:\n1. Infer your project type\n2. Propose relevant evaluation categories for you to confirm\n3. Analyze the project and present findings with Impact + Confidence ratings\n4. Offer to save the report and/or generate an implementation plan for selected findings\n\n**Tip:** Run with different models to get different perspectives on the same codebase.\n\n## Installation\n\n### From the mackayi marketplace (recommended)\n\n```\n/plugin marketplace add keithmackay/mackayi\n/plugin install improve-this@mackayi\n```\n\n### Claude Code\n\n```bash\n# Global (available in all projects)\ncp SKILL.md ~/.claude/skills/improve-this/SKILL.md\n\n# Or symlink the whole directory\nln -s /path/to/improve-this/ ~/.claude/skills/improve-this\n```\n\nThen invoke with: `/improve-this`\n\n### Codex\n\nAdd to your marketplace JSON (`~/.agents/plugins/marketplace.json`, create if absent):\n\n```json\n{\n  \"name\": \"personal\",\n  \"interface\": { \"displayName\": \"Personal Plugins\" },\n  \"plugins\": [\n    {\n      \"name\": \"improve-this\",\n      \"source\": { \"source\": \"local\", \"path\": \"/path/to/improve-this/\" },\n      \"policy\": { \"installation\": \"AVAILABLE\", \"authentication\": \"ON_INSTALL\" },\n      \"category\": \"Productivity\"\n    }\n  ]\n}\n```\n\n### Antigravity\n\nThe root `SKILL.md` is fully Antigravity-compatible (no platform-specific metadata to strip).\n\n```bash\n# Global install (all workspaces)\ncp -r /path/to/improve-this/ ~/.gemini/antigravity/skills/improve-this/\n\n# Workspace install (current project only)\ncp -r /path/to/improve-this/ .agents/skills/improve-this/\n```\n\nSkills are auto-discovered. Mention `/improve-this` to activate.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/keithmackay/improve-this\n```\n\nTo update:\n```bash\ngemini extensions update improve-this\n```\n\nThe skill is auto-discovered from `GEMINI.md` after installation.\n\n## Compatibility\n\n| Feature | Claude Code | Codex | Antigravity | Gemini CLI |\n|---------|:-----------:|:-----:|:-----------:|:----------:|\n| Core skill | ✅ | ✅ | ✅ | ✅ |\n| Subagent dispatch | ✅ | ✅ | ✅ | ❌ |\n\nLegend: ✅ Supported · ❌ Not supported\n\n> **Gemini CLI note:** This skill does not use subagent dispatch, so full functionality is available on all platforms.\n\n## Maintaining this skill\n\n`skills/improve-this/SKILL.md` is the source of truth for the skill body. Neither Claude Code nor Antigravity supports including one file's content inside another, so `improve-this.md` and the root `SKILL.md` are manually kept as synced copies (`GEMINI.md` avoids this by using Gemini CLI's `@`-include convention instead). After editing the skill body, run `scripts/check-sync.sh` to confirm all three copies still match.\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for release history.\n\n## License\n\nMIT\n\n## References\n\n- **Claude Code Skills:** https://code.claude.com/docs/en/skills\n- **Claude Code Complete Guide (PDF):** https://resources.anthropic.com/hubfs/The-Complete-Guide-to-Building-Skill-for-Claude.pdf\n- **Codex Plugins:** https://developers.openai.com/codex/plugins/build\n- **Antigravity Skills:** https://antigravity.google/docs/skills\n- **Gemini CLI Extensions:** https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md\n- **Agent Skills open standard:** https://agentskills.io/home\n",
  "bytes": 3901,
  "sha": "7ef753b42af03295e998cc808eba88c6cdd53ef80831473f732d795f0807aece",
  "repo_slug": "keithmackay/improve-this",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_keithmackay_improve_this_76634401/readme"
}