josepfernande/ferna-dots/skill-improver
Claude Code and agent skill by josepfernande/ferna-dots
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 josepfernande/ferna-dots/skill-improverSKILL.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.mdas the normative style contract when it exists. - Treat
SKILL.mdas the source of truth; preserve author intent, critical rules, activation semantics, and output requirements. - Use
.atl/skill-registry.mdas 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/orassets/. - Do not invent triggers, policies, or domain rules. Mark ambiguous cases for human review.
Decision Gates
| Situation | Action | |
|---|---|---|
| Missing or invalid frontmatter | Fix name, quoted one-line description, license, and metadata | |
| Skill reads like tutorial docs | Convert to runtime instructions and move background to references/ | |
| Body exceeds budget | Preserve rules, move examples/background to supporting files | |
| Branching logic hidden in prose | Convert to a compact decision table | |
| Rules conflict or intent is unclear | Report the issue; do not rewrite that rule automatically |
Execution Steps
- 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. - Read
.atl/skill-registry.md; use listed paths to select skills. If missing, scan known skill directories for*/SKILL.md. - For each selected skill, audit metadata, trigger clarity, section order, body budget, actionability, decision gates, output contract, and local references.
- Return an audit report grouped by skill with severity and exact proposed changes.
- 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, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingopencode/skills/skill-improver/SKILL.md
Popularity
- 7-day trend score
- 5
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
[](https://verified-skill.com/skills/josepfernande/ferna-dots/skill-improver)