skill-creator

Create and iteratively improve LLM skill definitions with evaluation workflows.

Updated Jan 26, 2023
One-click install
npx skills add https://github.com/yuyalun-allen/dotfiles --skill skill-creator-yuyalun-allen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/yuyalun-allen/dotfiles/tree/main/tools/pi/agent/skills/skill-creator
Command: npx skills add https://github.com/yuyalun-allen/dotfiles --skill skill-creator-yuyalun-allen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Reduce the friction of designing, testing, and iterating on Claude-style skills by providing a repeatable, well-documented workflow that covers drafting SKILL.md, creating evals, running with-skill vs baseline comparisons, grading outputs, and packaging the final skill. It saves time and improves reliability by bundling scripts and conventions so authors can focus on intent and evaluation rather than orchestration.

Core Features & Use Cases

  • Guided Skill Authoring: Templates and guidance for SKILL.md frontmatter, trigger descriptions, and instructional bodies so new skills are discovery-ready.
  • Eval + Improve Loop: Tools to create eval sets, spawn parallel with-skill and baseline runs, capture timing/tokens, draft assertions, and iterate descriptions based on held-out tests.
  • Benchmarking & Review: Aggregation, viewer generation, blind comparison and analysis agents to produce benchmark.json, human-review HTML, and actionable recommendations.
  • Packaging & Utilities: Validation and packaging scripts to produce distributable .skill files and helper scripts for common patterns (grading, aggregation, report generation).
  • Use Case: Create a new skill, run 2–3 realistic test prompts, compare with baselines, iterate the description, and produce a packaged .skill ready for distribution.

Quick Start

Ask the assistant to draft a SKILL.md for a new skill called my-skill, produce 2–3 realistic eval prompts, run the evaluation-and-improve loop, and return a packaged .skill for installation.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create and iterate on AI skill definitions with evaluation workflows?

To create and iterate on AI skill definitions, use a guided workflow that drafts SKILL.md entry points, authors evals, and runs with-skill versus baseline comparisons to aggregate benchmark metrics and optimize descriptions for reliable triggering.

What's the best way to benchmark LLM skills against a baseline?

The best way to benchmark LLM skills is to spawn parallel with-skill and baseline runs, capture timing and token data, grade outputs with assertions, and aggregate results into a benchmark.json file for actionable analysis.

How do I package a Claude skill for deployment and distribution?

To package a Claude skill for deployment, run validation and packaging scripts that produce a distributable .skill file, ensuring the SKILL.md frontmatter, trigger descriptions, and instructional bodies are discovery-ready.

How does skill description optimization work for reliable triggering?

Skill description optimization works by testing trigger descriptions against held-out eval prompts, comparing performance, and iterating the description text until the skill reliably activates for the intended use cases.

Do I need pyyaml to run skill creation and benchmarking scripts?

Yes, you need pyyaml installed as a dependency to run the skill creation and benchmarking scripts that handle configuration parsing, eval spawning, output grading, and benchmark aggregation.

Can I generate a human-review viewer to compare skill evaluation outputs?

Yes, you can generate a human-review HTML viewer and use blind comparison analysis agents to review skill evaluation outputs, producing actionable recommendations for further skill improvement.