skills.rest
oornnery
oornneryCOMMUNITY
Explore all skills by this author →
GitHub

skill-builder

Create and refactor local skills with structured SKILL.md files.

Updated Jan 14, 2026
Search Tags:#workflow#metadata#refactor#taxonomy#references#skill-builder
One-click install
npx skills add https://github.com/oornnery/skills --skill skill-builder-oornnery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-builder
Source: https://github.com/oornnery/skills/tree/main/skills/skill-builder
Command: npx skills add https://github.com/oornnery/skills --skill skill-builder-oornnery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating and maintaining local skills can become messy as teams merge, split, or reorganize capabilities. The Skill Builder helps ensure a lean SKILL.md, clear triggers, and minimal duplication by guiding how to craft or refactor skills and where to place deeper guidance.

Core Features & Use Cases

  • Lean frontmatter and procedural SKILL.md design to keep context tight
  • Clear boundaries (skills/ under skills/, references/ for extended guidance, and minimal duplication across skills)
  • A repeatable workflow: choose the smallest home, write metadata, keep essentials, avoid duplication, validate alignment with taxonomy

Quick Start

Audit an existing skill and refactor its SKILL.md to point to lean references, then apply the workflow to consolidate content or create a new, well-scoped skill.

Frequently Asked Questions about skill-builder

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

FAQPage Schema
How do I refactor local skills to reduce content duplication and improve taxonomy?▼

To refactor local skills and remove duplication, audit existing SKILL.md files and migrate extended guidance into linked references. This keeps context tight and maintains consistent skill boundaries across your organizational taxonomy.

What's the best way to structure metadata for a new local skill workflow?▼

The best way to structure skill metadata is using lean front-matter bounded by clear validation guardrails. This enforces consistent alignment with your taxonomy and ensures predictable updates during the skill creation workflow.

When should I move extended guidance out of SKILL.md into separate references?▼

You should move extended guidance into separate references when SKILL.md becomes bloated and exceeds its essential boundaries. Relocating deeper content keeps context tight and ensures the core file remains a lean procedural entry point.

Does this skill builder workflow support consolidating overlapping capabilities after a team merge?▼

Yes, the skill builder workflow supports consolidating overlapping capabilities after a team merge. It guides you in finding the smallest home for content, removing duplication, and validating metadata alignment across the reorganized taxonomy.

How do I validate linked references and metadata alignment when updating local skills?▼

You validate linked references and metadata alignment by applying guardrails during your refactor cycle. This predictable process ensures SKILL.md updates and content migrations maintain structural integrity and discoverability.

Related Skills

Explore More Software Engineering Skills→
SempriniSemprini
1

baseline-capture

Document existing data assets as MD-DDL baseline files.

Community
Intermediate
korchasakorchasa

diagnose-benchmark-failure

Diagnose flowai benchmark failures by comparing run artifacts against a failure taxonomy.

Community
Advanced
lpjhelderlpjhelder

trace

Display agent session flow traces with chronological timelines and summaries.

Community
Intermediate
apexbusiness-systemsapexbusiness-systems
4

testing-skills-with-subagents

Run RED-GREEN-REFACTOR tests to validate skill documentation under pressure.

Community
Basic