skill-from-trial-run

Builds and refines new agent skills through a five-phase ideate, build, trial, review, iterate loop.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/christian-byrne/comfy-skills --skill skill-from-trial-run-christian-byrne
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-from-trial-run
Source: https://github.com/christian-byrne/comfy-skills/tree/main/skills/skill-from-trial-run
Command: npx skills add https://github.com/christian-byrne/comfy-skills --skill skill-from-trial-run-christian-byrne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New agent skills often ship untested, with ambiguous instructions, missing tool fallbacks, and unclear triggers that only surface when a real agent runs them. This Skill enforces a structured trial-run process so every skill is validated by a fresh agent before merging. ## Core Features & Use Cases - Five-Phase Workflow: Ideate features and tools, build SKILL.md plus reference files, run a trial in a separate agent thread, review the trial thread for failures, then iterate and open a PR. - Structured Trial Review: Classifies trial issues into categories like tool failures, ambiguous instructions, missing fallbacks, monorepo issues, and output quality, then maps each to a fix target. - Quality Gates: Enforces a build checklist covering frontmatter validity, description triggers, cross-reference integrity, line limits under 500, and skill-lint execution when available. - Use Case: When you say "build a skill for running security audits", the Skill brainstorms the feature set with you, authors the SKILL.md, has you trial it in a clean agent thread, reads that thread for friction points, and iterates until the skill passes all quality checks. ## Quick Start Ask the agent to build a new skill for your chosen task using the trial-run workflow and approve the proposed scope when prompted.

Frequently Asked Questions about skill-from-trial-run

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

FAQPage Schema
How do I build a new agent skill from scratch?▼

Follow the five-phase loop: ideate the feature set with user approval, build the SKILL.md and reference files, run a trial in a separate agent thread, review that thread for failures, then iterate and open a PR. Each phase has an explicit checklist to complete before moving on.

Why must the skill trial run in a separate agent thread?▼

A separate thread gives a clean signal because the trial agent has no context from the build conversation. Same-thread testing produces false confidence since the agent already knows the intent, hiding ambiguous instructions and missing fallbacks.

What quality checks should a SKILL.md pass before merging?▼

The frontmatter name must match the directory, the description needs "Use when..." triggers, all referenced files must exist, the file must stay under 500 lines, and skill-lint should pass if available. Tool commands also need explicit fallback guidance.

How are trial run failures classified and fixed?▼

Issues are categorized as tool failures, ambiguous instructions, missing fallbacks, monorepo issues, API limitations, output quality, prompt construction, or ordering problems. Each category maps to a fix target such as the tool-setup reference, the SKILL.md workflow, or added templates.

When should I not use the trial-run workflow?▼

Avoid it for trivial personal utilities that do not need production quality gates. The process is designed for repo skills intended for reuse, where skipping the trial or reviewing your own output would leave defects undetected.