Agent-Skills.md

Agent Skills: Improve Skill

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".

UncategorizedID: ANcpLua/ancplua-claude-plugins/improve-skill

Repository

ANcpLua/ancplua-claude-plugins
ANcpLuaLicense: MIT
51

Install this agent skill to your local

pnpm dlx add-skill https://github.com/ANcpLua/ancplua-claude-plugins/tree/HEAD/plugins/cc-plugin-eval/skills/improve-skill

Skill Files

Browse the full folder contents for improve-skill.

Download Skill

Loading file tree…

plugins/cc-plugin-eval/skills/improve-skill/SKILL.md

Skill Metadata

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.

The runnable commands below invoke the shipped script through the plugin root, which works in any checkout: node "${CLAUDE_PLUGIN_ROOT}/scripts/cc-plugin-eval.js" <command> <args>. Inline mentions of cc-plugin-eval <command> are shorthand for that same invocation; the bare cc-plugin-eval alias only exists if you ran npm link in the plugin directory.

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

node "${CLAUDE_PLUGIN_ROOT}/scripts/cc-plugin-eval.js" analyze <skill-path> --brief-out ./skill-brief.json
node "${CLAUDE_PLUGIN_ROOT}/scripts/cc-plugin-eval.js" improve <skill-path> --brief-out ./skill-brief.json --format markdown
node "${CLAUDE_PLUGIN_ROOT}/scripts/cc-plugin-eval.js" analyze <skill-path> --output ./after.json
node "${CLAUDE_PLUGIN_ROOT}/scripts/cc-plugin-eval.js" compare ./before.json ./after.json --format markdown

Reference

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