Live Demo

Interactive Pipeline Visualizer

The graph below shows a dev-team pipeline compiled from skillfold.yaml. Click any node to see its composition, state reads/writes, and description.

Generate this for your own pipeline:

npx skillfold graph --html > pipeline.html

Quick Start

Scaffold a pipeline, compile it, and see the output in under 30 seconds:

# Scaffold from a template
npx skillfold init my-team --template dev-team
cd my-team

# Compile to standard SKILL.md files
npx skillfold

# Or compile directly to Claude Code agents
npx skillfold --target claude-code

# Visualize the flow
npx skillfold graph --html > pipeline.html

Example Config

This is the dev-team template config that generates the graph above:

name: dev-team

imports:
  - npm:skillfold/library/skillfold.yaml

skills:
  composed:
    planner:
      compose: [planning, decision-making]
      description: "Analyzes the goal and produces a structured plan."

    engineer:
      compose: [planning, code-writing, testing]
      description: "Implements the plan by writing production code and tests."

    reviewer:
      compose: [code-review, testing]
      description: "Reviews code for correctness, clarity, and test coverage."

    orchestrator:
      compose: [planning]
      description: "Coordinates pipeline execution."

state:
  Review:
    approved: bool
    feedback: string

  plan:
    type: string
  implementation:
    type: string
  review:
    type: Review

team:
  orchestrator: orchestrator

  flow:
    - planner:
        writes: [state.plan]
      then: engineer

    - engineer:
        reads: [state.plan]
        writes: [state.implementation]
      then: reviewer

    - reviewer:
        reads: [state.implementation]
        writes: [state.review]
      then:
        - when: review.approved == false
          to: engineer
        - when: review.approved == true
          to: end

What the Compiler Produces

Running npx skillfold on this config generates four SKILL.md files:

Agent	Composed From	Description
planner	planning + decision-making	Plans and makes key decisions
engineer	planning + code-writing + testing	Writes code and tests
reviewer	code-review + testing	Reviews code quality
orchestrator	planning + generated execution plan	Coordinates the flow

The engineer agent's SKILL.md contains the bodies of planning, code-writing, and testing concatenated in order - no duplication, no drift.