skill-improver

Audit and refactor existing SKILL.md files against an LLM-first style guide.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/zMynxx/bifrost-with-opencode --skill skill-improver-zmynxx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-improver
Source: https://github.com/zMynxx/bifrost-with-opencode/tree/main/.opencode/skills/skill-improver
Command: npx skills add https://github.com/zMynxx/bifrost-with-opencode --skill skill-improver-zmynxx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Existing SKILL.md files often drift from the required structure: invalid frontmatter, tutorial-style prose, missing decision gates, or bloated bodies. This Skill audits and normalizes them against a normative style guide without losing author intent. ## Core Features & Use Cases - Structured Auditing: Checks frontmatter validity, trigger clarity, section order, body token budget, decision gates, and output contracts for each skill. - Safe Apply Mode: Defaults to audit-only and only edits files when explicitly requested, moving long content into local references/ or assets/ instead of deleting it. - Style Guide Enforcement: Uses docs/skill-style-guide.md or a bundled local copy as the normative contract, and consults .atl/skill-registry.md for skill discovery. - Use Case: After adding several new skills to a repo, run an audit to find skills with missing frontmatter or oversized bodies, then apply safe fixes and refresh the skill registry. ## Quick Start Audit all skills in this repository against the skill style guide and report issues grouped by severity.

Frequently Asked Questions about skill-improver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit existing SKILL.md files for quality?▼

Invoke the skill-improver skill, which reads the style guide and skill registry, then checks each SKILL.md for frontmatter validity, section order, body budget, and decision gates. It returns a report grouped by skill with severity levels and proposed changes.

What structure should a SKILL.md file follow?▼

A SKILL.md should contain frontmatter with name, description, license, and metadata, followed by Activation Contract, Hard Rules, Decision Gates, Execution Steps, Output Contract, and References sections. The body should target 180-450 tokens with a hard maximum of 1000.

Does the skill modify files automatically during an audit?▼

No, it defaults to audit-only mode and only reports issues. Files are modified only when the user explicitly requests apply mode, and meaningful content is moved to references/ or assets/ rather than deleted.

What happens when a skill rule is ambiguous or conflicting?▼

Conflicting rules or unclear intent are flagged for human review instead of being rewritten automatically. The skill never invents triggers, policies, or domain rules during refactoring.

When should I use skill-improver instead of skill-creator?▼

Use skill-improver when auditing, refactoring, or normalizing existing SKILL.md files. Use skill-creator only when building a brand-new skill from a reusable pattern.