skill-creator

Create, evaluate, and iteratively improve Claude skills with benchmarked test runs.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill skill-creator-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/skill-creator
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill skill-creator-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Writing a skill that triggers reliably and produces good outputs is hard to do by intuition alone. This Skill guides you through drafting a skill, running structured test cases with baselines, collecting user feedback, benchmarking performance, and optimizing the description for accurate triggering. ## Core Features & Use Cases - Guided Skill Authoring: Interviews you about intent, edge cases, and output formats, then writes a well-structured SKILL.md following progressive disclosure and writing-style best practices. - Evaluation & Benchmarking: Runs test prompts with and without the skill in parallel, grades outputs against assertions, and aggregates pass rates, timing, and token usage into benchmark reports with an interactive HTML review viewer. - Description Optimization: Generates realistic trigger/no-trigger eval queries, reviews them with you in an editable HTML page, and runs an automated loop that rewrites the skill description to maximize triggering accuracy on held-out test queries. - Use Case: You want a skill that formats weekly sales spreadsheets. This Skill helps you draft it, tests it on realistic prompts, shows you side-by-side results versus no skill, and iterates until the outputs pass your review. ## Quick Start Help me create a new skill that converts meeting notes into structured action items, then test and improve it.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create a new Claude skill from scratch?

Start by describing what the skill should do and when it should trigger. The skill creator interviews you about edge cases and output formats, drafts a SKILL.md with proper frontmatter, then runs test prompts to validate behavior before iterating on feedback.

How do I test whether my skill actually improves outputs?

Run each test prompt twice in parallel: once with the skill and once without as a baseline. Grade both outputs against objective assertions, then aggregate pass rates, timing, and token usage into a benchmark comparing the two configurations.

How do I optimize a skill description for better triggering?

Generate 20 realistic trigger and no-trigger eval queries, review them in the HTML editor, then run the optimization loop. It rewrites the description iteratively and selects the best version based on held-out test query scores to avoid overfitting.

What makes a good skill description for triggering?

A good description states both what the skill does and specific contexts when to use it, including phrasings users might actually type. Slightly pushy descriptions combat undertriggering, and all when-to-use information belongs in the description, not the body.

Does skill evaluation work on Claude.ai without subagents?

Yes, but with adaptations. Without subagents you run test cases sequentially yourself, skip baseline comparisons and quantitative benchmarking, and present results inline for qualitative feedback instead of using the browser-based review viewer.

Why do my skill test results vary between runs?

Variance comes from non-deterministic model behavior, which is why the benchmark runs each configuration multiple times and reports mean with standard deviation. High-variance evals may indicate flaky assertions or ambiguous skill instructions worth clarifying.