Skills System Guide
Reusable Claude prompts that automate complex workflows
𧩠What are Skills?
Skills are reusable Claude prompts that automate complex, multi-step workflows. Each skill is a structured SKILL.md file stored in ~/.claude/skills/ and invoked directly from Claude Code.
Structured Workflows
Multi-step processes with gates and checkpoints
Reusable
Install once, use across projects with variable substitution
AI-Powered
Claude follows the skill instructions automatically via MCP
π Quick Start 3 Steps
Get up and running with skills in minutes.
List available skills
list_skills()Shows all available and installed skills with their status.
Install with variables
install_skill({
name: "story-engine",
variables: { PROJECT: "/path/to/episode" }
})Variables like {{PROJECT}} are replaced during installation.
Use in Claude Code
The skill appears in the Claude Code command palette. Claude automatically follows the workflow defined in the skill.
π¦ Available Skills
π Story Engine v0.9
YouTube story channel script writing automation. Designed for traditional tales, folk stories, and historical narratives. Covers the full pipeline from story analysis to upload-ready assets.
Variables
PROJECT
(required)
β Path to the episode folder
π 12-Step Workflow
The Story Engine follows a strict 12-step pipeline with gate checks between phases.
Story Analysis
Analyze a reference story for success factors, audience hooks, and narrative structure.
Fact Check
Validate historical accuracy, period-correct details, and factual consistency.
Synopsis
Create a 20-chapter framework with plot structure and character arcs.
Preflight
Structure review, forbidden-content checks, and foreshadowing tracking.
Script Writing
Write the full script in 5 parts: Introduction → Development → Twist → Resolution → Hook.
Review
Iterative sub-agent review rounds (up to 5 rounds) for quality assurance.
Finalize User Approval Required
User approval checkpoint. The script cannot proceed to production without explicit confirmation.
Production Extract
Split the script into narration, character voices, and SFX cues.
Extract Review
Sub-agent validation of the extracted production data.
TTS / SFX Generate
Generate audio files with AI TTS APIs (ElevenLabs, Typecast) and sound effects.
Storyboard CSV
Create references.csv and scenes.csv for image/video generation with AutoFlowCut.
Image / Video Generation
Batch generation with Flow AI via AutoFlowCut MCP tools and quality assurance.
Upload Info
Prepare title, description, tags, and thumbnail for YouTube upload.
βοΈ Skill Management
list_skills()
View all available and installed skills with their status and metadata.
install_skill(name, variables)
Install a skill with template variable substitution. The skill file is copied to ~/.claude/skills/.
uninstall_skill(name)
Remove an installed skill from the skills directory.
π οΈ Creating Custom Skills
You can create your own skills to automate any workflow.
File Structure
skills/
{skill-name}/
SKILL.md # Workflow instructions
metadata.json # Name, description, variables
docs/ # Reference documents (optional)Template Variables
Use {{VAR_NAME}} placeholders in SKILL.md. They are replaced with actual values during installation.
Example: {{PROJECT}} in the skill file becomes /Users/me/workspace/ep01 after installation.