improve-skill

name	improve-skill
description	Convert cc-plugin-eval findings into a concrete rewrite brief, then hand off to skill-creator for the edit pass. Use when the user already ran an evaluation and now wants a fix plan, after asking "what should I fix first" or "rewrite this using the findings".

Improve Skill

Use this skill after cc-plugin-eval has already produced findings for a local skill.

What This Skill Does NOT Do

This skill does not perform LLM-driven rewrites. That is the job of the skill-creator skill (Anthropic's skill-creator@claude-plugins-official). cc-plugin-eval produces structured findings and a rewrite brief; skill-creator turns the brief into edits with subagent-driven evals and grading. Keep the two boundaries clear.

Workflow

1. Run cc-plugin-eval analyze <skill-path> --brief-out ./skill-brief.json. The same payload is also produced by cc-plugin-eval improve <skill-path> --brief-out ./skill-brief.json, which writes the improvement brief as the top-level payload.
2. Read the improvement brief. Group work into required fixes (severity error or fail) versus recommended fixes (severity warn or info).
3. Hand the brief to skill-creator. That skill specializes in skill rewrites with subagent-driven evals.
4. Re-run cc-plugin-eval analyze <skill-path> --output ./after.json and use cc-plugin-eval compare ./before.json ./after.json --format markdown to measure the delta.

Focus Areas

• reduce trigger and invoke token costs (move bulky details into references, scripts, or helper files)
• keep SKILL.md compact (target under 500 lines; hard limit at 800; reference threshold is 350)
• improve trigger descriptions so Claude reliably routes to the skill (CC203, CC204)
• fix broken relative links (CC211), oversized descriptions (CC202), and frontmatter issues (CC213)
• normalize allowed-tools syntax (CC215) and add disable-model-invocation to task-style skills where appropriate (CC216)

Chat Requests To Recognize

• Improve this skill based on the evaluation.
• Rewrite this skill using the cc-plugin-eval findings.
• What should I fix first in this skill?
• Hand the brief to skill-creator.

Commands

cc-plugin-eval analyze <skill-path> --brief-out ./skill-brief.json
cc-plugin-eval improve <skill-path> --brief-out ./skill-brief.json --format markdown
cc-plugin-eval analyze <skill-path> --output ./after.json
cc-plugin-eval compare ./before.json ./after.json --format markdown

Reference

• ../../references/chat-first-workflows.md
• ../../references/evaluation-result-schema.md