wilberhernan/opencode-will/skill-improver

Claude Code and agent skill by wilberhernan/opencode-will

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Trigger: improve skills, audit skills, refactor skills, skill quality. Audit and upgrade existing LLM-first skills.

Install

npx vskill@latest install wilberhernan/opencode-will/skill-improver

SKILL.md

The same SKILL.md was published earlier as josepfernande/ferna-dots/skill-improver.

Activation Contract

Use this skill when asked to audit, refactor, normalize, or improve existing SKILL.md files. Use skill-creator instead when creating a brand-new skill from a reusable pattern.

Hard Rules

  • Treat docs/skill-style-guide.md as the normative style contract when it exists.
  • Treat SKILL.md as the source of truth; preserve author intent, critical rules, activation semantics, and output requirements.
  • Use .atl/skill-registry.md as an index of skill names, triggers, scopes, and exact paths; do not expect generated summaries.
  • Default to audit-only. Modify files only when the user explicitly asks to apply improvements.
  • Never delete meaningful content silently; move long explanation, examples, templates, or schemas into local references/ or assets/.
  • Do not invent triggers, policies, or domain rules. Mark ambiguous cases for human review.

Decision Gates

SituationAction
Missing or invalid frontmatterFix name, quoted one-line description, license, and metadata
Skill reads like tutorial docsConvert to runtime instructions and move background to references/
Body exceeds budgetPreserve rules, move examples/background to supporting files
Branching logic hidden in proseConvert to a compact decision table
Rules conflict or intent is unclearReport the issue; do not rewrite that rule automatically

Execution Steps

  1. Read docs/skill-style-guide.md; if unavailable, enforce the core LLM-first structure: frontmatter, Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, References.
  2. Read .atl/skill-registry.md; use listed paths to select skills. If missing, scan known skill directories for */SKILL.md.
  3. For each selected skill, audit metadata, trigger clarity, section order, body budget, actionability, decision gates, output contract, and local references.
  4. Return an audit report grouped by skill with severity and exact proposed changes.
  5. In apply mode, edit only safe issues, preserve content, create supporting files when needed, then rerun or request gentle-ai skill-registry refresh.

Output Contract

Return:

  • Skills audited and paths used.
  • Issues found, grouped by severity.
  • Files changed, if apply mode was requested.
  • Registry refresh recommendation when skill metadata or paths changed.
  • Ambiguities that need human review.

References

  • docs/skill-style-guide.md — normative LLM-first skill style guide for this repo.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/wilberhernan/opencode-will/skill-improver/badge)](https://verified-skill.com/skills/wilberhernan/opencode-will/skill-improver)

Something wrong with this skill or its page? Tell us.