skill-development

Create, evaluate, and benchmark Claude Code plugin skills with structured workflows.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/karimStekelenburg/k3m-marketplace --skill skill-development-karimstekelenburg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-development
Source: https://github.com/karimStekelenburg/k3m-marketplace/tree/main/plugins/plugin-dev/skills/skill-development
Command: npx skills add https://github.com/karimStekelenburg/k3m-marketplace --skill skill-development-karimstekelenburg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve? Writing effective Claude Code plugin skills requires knowing the SKILL.md format, frontmatter conventions, progressive disclosure patterns, and how to measure whether a skill actually triggers and performs well. This Skill provides the complete authoring methodology plus an evaluation and benchmarking toolkit so skills are discoverable, lean, and measurably effective. ## Core Features & Use Cases - Skill Authoring Guidance: Step-by-step process covering SKILL.md frontmatter, third-person trigger descriptions, imperative writing style, and progressive disclosure across scripts/, references/, and assets/. - Eval & Benchmark Infrastructure: Scripts to run trigger evals, iterate on descriptions with a train/test split, aggregate benchmark statistics, and generate HTML reports. - Review Agents & Viewer: Grader, blind comparator, and analyzer agents plus an interactive eval-viewer for reviewing run outputs and collecting feedback. - Use Case: A plugin author writes a new skill, runs the eval loop to optimize its description against trigger queries, benchmarks it against a baseline configuration, and reviews results in the HTML viewer before shipping. ## Quick Start Ask Claude to create a new skill for your plugin and follow the guided skill creation process.

Frequently Asked Questions about skill-development

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

FAQPage Schema
How do I create a skill for a Claude Code plugin?▼

Create a directory under your plugin's skills/ folder containing a SKILL.md file with YAML frontmatter defining name and description, followed by Markdown instructions. Optionally add scripts/, references/, and assets/ directories for bundled resources.

How to write a good skill description for Claude Code?▼

Write the description in third person with specific trigger phrases users would actually say, such as "create a hook" or "validate settings". Keep the most important trigger context in the first 250 characters since the /skills listing truncates display there.

How do I test whether my skill triggers on the right queries?▼

Use the included eval scripts to run trigger evals against a set of queries marked should_trigger true or false. The run_loop.py script iterates on the description with a train/test split and generates an HTML report of results.

What is progressive disclosure in Claude Code skills?▼

Progressive disclosure is a three-level loading system: metadata stays in context always, the SKILL.md body loads when the skill triggers, and bundled resources load only as needed. Keep SKILL.md between 1,500 and 2,000 words and move detailed content to references/.

What frontmatter fields does SKILL.md support?▼

SKILL.md requires name and description fields, and optionally supports version, effort (low, medium, high), inline hooks scoped to the skill's lifetime, and paths for glob-based activation. The description drives when Claude selects the skill.

When should I put content in references/ instead of SKILL.md?▼

Move detailed patterns, API documentation, migration guides, and edge cases to references/ when they are not core procedural instructions. This keeps SKILL.md lean and loads detailed content only when Claude determines it is needed.