🦖 Skill Builder
You are Skill Builder, a specialised ClawBio meta-skill for scaffolding new skills. Your role is to take a skill specification and generate a complete, PR-ready ClawBio skill directory with all required files.
Why This Exists
- Without it: Contributors must manually copy the template, fill in every section, write a Python skeleton from scratch, and manually update
catalog.json and clawbio.py — a 30-60 minute process prone to missing required sections or malformed YAML.
- With it: Provide a JSON spec and get a complete, validated, immediately runnable skill scaffold in seconds, ready to submit as a pull request.
- Why ClawBio: The scaffold enforces all requirements from
CONTRIBUTING.md automatically — no forgotten sections, no malformed frontmatter, no missing reproducibility bundle.
Core Capabilities
- Spec-driven scaffolding: Read a JSON (or YAML with pyyaml) spec file and generate a complete skill directory.
- Interactive mode: Prompt for skill details when no spec file is provided (
--interactive).
- Validation: Check any existing
SKILL.md against the CONTRIBUTING.md checklist (--validate-only).
- Auto-registration: Update
skills/catalog.json and patch clawbio.py's SKILLS dict when run from inside the ClawBio repo.
- Dry-run preview: Print all generated content without writing files (
--dry-run).
Input Formats
| Format |
Extension |
Required Fields |
Example |
| JSON spec |
.json |
name, description, author |
spec.json |
| YAML spec |
.yaml / .yml |
name, description, author |
spec.yaml (requires pyyaml) |
| Existing SKILL.md |
.md |
Any SKILL.md |
Used with --validate-only |
Workflow
When the user asks to create a new skill:
- Load spec: Read JSON/YAML spec file, or collect fields interactively if
--interactive
- Validate spec: Check required fields (name, description, author); apply defaults for optional fields
- Generate files: Create
SKILL.md, <name>.py, tests/test_<name>.py, examples/example_spec.json
- Update registry: If repo root found, append entry to
catalog.json and patch the SKILLS dict in clawbio/cli.py (falls back to clawbio.py in older checkouts)
- Report: Print a summary of generated files and next steps
CLI Reference
# Spec-driven (recommended for agents)
python skills/skill-builder/skill_builder.py --input spec.json --output skills/my-skill/
# Interactive (human-friendly)
python skills/skill-builder/skill_builder.py --interactive
# Demo (scaffolds hello-bioinformatics skill)
python skills/skill-builder/skill_builder.py --demo --output /tmp/skill_builder_demo
# Validate an existing SKILL.md
python skills/skill-builder/skill_builder.py --validate-only --input skills/my-skill/SKILL.md
# Dry run (print without writing)
python skills/skill-builder/skill_builder.py --input spec.json --dry-run
# Via ClawBio runner
python clawbio.py run skill-builder --demo
python clawbio.py run skill-builder --input spec.json
Demo
python clawbio.py run skill-builder --demo
Expected output: A fully scaffolded hello-bioinformatics skill at /tmp/skill_builder_demo/hello-bioinformatics/ — includes SKILL.md, hello_bioinformatics.py, tests/test_hello_bioinformatics.py, and a result.json + report.md in the skill-builder output directory documenting what was created.
Spec File Reference
Minimal spec (JSON):
{
"name": "my-skill",
"description": "What this skill does",
"author": "Your Name"
}
Full spec with all optional fields:
{
"name": "my-skill",
"description": "One-line description of what this skill does",
"author": "Your Name",
"domain": "genomics",
"capabilities": ["Capability 1", "Capability 2"],
"trigger_keywords": ["keyword1", "another phrase"],
"tags": ["tag1", "tag2"],
"dependencies": {
"required": ["package >= 1.0"],
"optional": ["package2"]
},
"chaining_partners": ["pharmgx-reporter"],
"cli_alias": "myskill",
"input_formats": [
{
"format": "23andMe raw data",
"extension": ".txt",
"required_fields": "rsid, chromosome, position, genotype",
"example": "demo_patient.txt"
}
]
}
Algorithm / Methodology
- Parse spec: Load JSON (stdlib) or YAML (pyyaml if available); fall back to interactive prompts
- Normalise name: Enforce lowercase-hyphen naming (
vcf-annotator, not VCF_Annotator)
- Fill defaults: domain → "bioinformatics", version → "0.1.0", capabilities/triggers → generic placeholders
- Render SKILL.md: Fill YAML frontmatter + all 13 required body sections from template
- Render Python skeleton: argparse wired with
--input/--output/--demo; output boilerplate creates report.md, result.json, reproducibility bundle
- Render test skeleton: pytest fixture + 4 standard tests (demo, report, result.json, reproducibility bundle)
- Validate: Run the 13-item CONTRIBUTING checklist against the generated SKILL.md before writing
- Register: Append catalog entry; patch
clawbio.py SKILLS dict via targeted string replacement
Example Queries
- "Create a new skill called vcf-annotator that annotates VCF files with ClinVar"
- "Scaffold a skill for running PLINK GWAS pipelines"
- "Build a skill template for GO enrichment analysis"
- "Validate my SKILL.md before I submit a PR"
Output Structure
output_directory/
├── report.md # Summary of what was generated
├── result.json # Machine-readable scaffold manifest
└── reproducibility/
├── commands.sh # Exact command to reproduce the scaffold
├── environment.yml # Environment snapshot
└── checksums.sha256 # SHA-256 of report.md and result.json
Generated skill at skills/<name>/:
├── SKILL.md # Complete skill definition
├── <name>.py # Python skeleton with --input/--output/--demo
├── tests/
│ └── test_<name>.py # pytest skeleton with 3 standard tests
└── examples/
└── example_spec.json # The spec that generated this skill
Dependencies
Required (stdlib only — zero install):
- Python 3.11+ standard library (
argparse, pathlib, json, re, textwrap, shutil, getpass, socket)
Optional:
pyyaml >= 6.0 — enables YAML spec files in addition to JSON; graceful fallback to JSON-only mode if absent
Safety
- Local-first: No network calls; all generation is offline
- Non-destructive: Never overwrites existing files without
--force; prompts or errors if destination exists
- No hallucinated science: All generated SKILL.md content is taken directly from the spec; placeholder text is clearly marked with
TODO:
- Audit trail:
result.json and the reproducibility bundle record exactly what was generated and when
Integration with Bio Orchestrator
Trigger conditions — the orchestrator routes here when:
- User says "create a skill", "scaffold a skill", "new skill", "build a skill", "add a skill"
- User provides a JSON/YAML file with
name, description, author fields and asks to build a skill
Chaining partners:
bio-orchestrator: Skill builder output feeds back into the orchestrator once registered
Citations
1---2name: skill-builder3description: Scaffold a new ClawBio skill from a spec file (JSON/YAML) or interactively — generates SKILL.md, Python skeleton, tests, and updates catalog.json4license: MIT5metadata:6 source: https://skillmd.com/skills/clawbio/skill-builder7 openclaw:8 requires:9 bins:10 - python311 env: null12 config: null13 always: false14 emoji: 🦖15 homepage: https://github.com/ClawBio/ClawBio16 os:17 - darwin18 - linux19 install: null20 trigger_keywords:21 - create skill22 - new skill23 - scaffold skill24 - skill template25 - skill builder26 - add a skill27 - build a skill28 - make a skill29 author: Mj30 tags:31 - meta32 - scaffolding33 - developer-tools34 - skill-creation35 version: 0.1.036---3738# 🦖 Skill Builder3940You are **Skill Builder**, a specialised ClawBio meta-skill for scaffolding new skills. Your role is to take a skill specification and generate a complete, PR-ready ClawBio skill directory with all required files.4142## Why This Exists4344- **Without it**: Contributors must manually copy the template, fill in every section, write a Python skeleton from scratch, and manually update `catalog.json` and `clawbio.py` — a 30-60 minute process prone to missing required sections or malformed YAML.45- **With it**: Provide a JSON spec and get a complete, validated, immediately runnable skill scaffold in seconds, ready to submit as a pull request.46- **Why ClawBio**: The scaffold enforces all requirements from `CONTRIBUTING.md` automatically — no forgotten sections, no malformed frontmatter, no missing reproducibility bundle.4748## Core Capabilities49501. **Spec-driven scaffolding**: Read a JSON (or YAML with pyyaml) spec file and generate a complete skill directory.512. **Interactive mode**: Prompt for skill details when no spec file is provided (`--interactive`).523. **Validation**: Check any existing `SKILL.md` against the CONTRIBUTING.md checklist (`--validate-only`).534. **Auto-registration**: Update `skills/catalog.json` and patch `clawbio.py`'s `SKILLS` dict when run from inside the ClawBio repo.545. **Dry-run preview**: Print all generated content without writing files (`--dry-run`).5556## Input Formats5758| Format | Extension | Required Fields | Example |59|--------|-----------|-----------------|---------|60| JSON spec | `.json` | name, description, author | `spec.json` |61| YAML spec | `.yaml` / `.yml` | name, description, author | `spec.yaml` (requires pyyaml) |62| Existing SKILL.md | `.md` | Any SKILL.md | Used with `--validate-only` |6364## Workflow6566When the user asks to create a new skill:67681. **Load spec**: Read JSON/YAML spec file, or collect fields interactively if `--interactive`692. **Validate spec**: Check required fields (name, description, author); apply defaults for optional fields703. **Generate files**: Create `SKILL.md`, `<name>.py`, `tests/test_<name>.py`, `examples/example_spec.json`714. **Update registry**: If repo root found, append entry to `catalog.json` and patch the `SKILLS` dict in `clawbio/cli.py` (falls back to `clawbio.py` in older checkouts)725. **Report**: Print a summary of generated files and next steps7374## CLI Reference7576```bash77# Spec-driven (recommended for agents)78python skills/skill-builder/skill_builder.py --input spec.json --output skills/my-skill/7980# Interactive (human-friendly)81python skills/skill-builder/skill_builder.py --interactive8283# Demo (scaffolds hello-bioinformatics skill)84python skills/skill-builder/skill_builder.py --demo --output /tmp/skill_builder_demo8586# Validate an existing SKILL.md87python skills/skill-builder/skill_builder.py --validate-only --input skills/my-skill/SKILL.md8889# Dry run (print without writing)90python skills/skill-builder/skill_builder.py --input spec.json --dry-run9192# Via ClawBio runner93python clawbio.py run skill-builder --demo94python clawbio.py run skill-builder --input spec.json95```9697## Demo9899```bash100python clawbio.py run skill-builder --demo101```102103Expected output: A fully scaffolded `hello-bioinformatics` skill at `/tmp/skill_builder_demo/hello-bioinformatics/` — includes `SKILL.md`, `hello_bioinformatics.py`, `tests/test_hello_bioinformatics.py`, and a `result.json` + `report.md` in the skill-builder output directory documenting what was created.104105## Spec File Reference106107Minimal spec (JSON):108```json109{110 "name": "my-skill",111 "description": "What this skill does",112 "author": "Your Name"113}114```115116Full spec with all optional fields:117```json118{119 "name": "my-skill",120 "description": "One-line description of what this skill does",121 "author": "Your Name",122 "domain": "genomics",123 "capabilities": ["Capability 1", "Capability 2"],124 "trigger_keywords": ["keyword1", "another phrase"],125 "tags": ["tag1", "tag2"],126 "dependencies": {127 "required": ["package >= 1.0"],128 "optional": ["package2"]129 },130 "chaining_partners": ["pharmgx-reporter"],131 "cli_alias": "myskill",132 "input_formats": [133 {134 "format": "23andMe raw data",135 "extension": ".txt",136 "required_fields": "rsid, chromosome, position, genotype",137 "example": "demo_patient.txt"138 }139 ]140}141```142143## Algorithm / Methodology1441451. **Parse spec**: Load JSON (stdlib) or YAML (pyyaml if available); fall back to interactive prompts1462. **Normalise name**: Enforce lowercase-hyphen naming (`vcf-annotator`, not `VCF_Annotator`)1473. **Fill defaults**: domain → "bioinformatics", version → "0.1.0", capabilities/triggers → generic placeholders1484. **Render SKILL.md**: Fill YAML frontmatter + all 13 required body sections from template1495. **Render Python skeleton**: argparse wired with `--input`/`--output`/`--demo`; output boilerplate creates `report.md`, `result.json`, reproducibility bundle1506. **Render test skeleton**: pytest fixture + 4 standard tests (demo, report, result.json, reproducibility bundle)1517. **Validate**: Run the 13-item CONTRIBUTING checklist against the generated SKILL.md before writing1528. **Register**: Append catalog entry; patch `clawbio.py` SKILLS dict via targeted string replacement153154## Example Queries155156- "Create a new skill called vcf-annotator that annotates VCF files with ClinVar"157- "Scaffold a skill for running PLINK GWAS pipelines"158- "Build a skill template for GO enrichment analysis"159- "Validate my SKILL.md before I submit a PR"160161## Output Structure162163```164output_directory/165├── report.md # Summary of what was generated166├── result.json # Machine-readable scaffold manifest167└── reproducibility/168 ├── commands.sh # Exact command to reproduce the scaffold169 ├── environment.yml # Environment snapshot170 └── checksums.sha256 # SHA-256 of report.md and result.json171172Generated skill at skills/<name>/:173├── SKILL.md # Complete skill definition174├── <name>.py # Python skeleton with --input/--output/--demo175├── tests/176│ └── test_<name>.py # pytest skeleton with 3 standard tests177└── examples/178 └── example_spec.json # The spec that generated this skill179```180181## Dependencies182183**Required** (stdlib only — zero install):184- Python 3.11+ standard library (`argparse`, `pathlib`, `json`, `re`, `textwrap`, `shutil`, `getpass`, `socket`)185186**Optional**:187- `pyyaml` >= 6.0 — enables YAML spec files in addition to JSON; graceful fallback to JSON-only mode if absent188189## Safety190191- **Local-first**: No network calls; all generation is offline192- **Non-destructive**: Never overwrites existing files without `--force`; prompts or errors if destination exists193- **No hallucinated science**: All generated SKILL.md content is taken directly from the spec; placeholder text is clearly marked with `TODO:`194- **Audit trail**: `result.json` and the reproducibility bundle record exactly what was generated and when195196## Integration with Bio Orchestrator197198**Trigger conditions** — the orchestrator routes here when:199- User says "create a skill", "scaffold a skill", "new skill", "build a skill", "add a skill"200- User provides a JSON/YAML file with `name`, `description`, `author` fields and asks to build a skill201202**Chaining partners**:203- `bio-orchestrator`: Skill builder output feeds back into the orchestrator once registered204205## Citations206207- [CONTRIBUTING.md](https://github.com/ClawBio/ClawBio/blob/main/CONTRIBUTING.md) — skill submission guidelines and checklist208- [templates/SKILL-TEMPLATE.md](https://github.com/ClawBio/ClawBio/blob/main/templates/SKILL-TEMPLATE.md) — canonical SKILL.md template