swarmskill-creator

Creates, converts, and validates multi-role Swarm Skills with optional SwarmFlow orchestration scripts.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/DreamMacer/jiuwenswarm --skill swarmskill-creator-dreammacer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: swarmskill-creator
Source: https://github.com/DreamMacer/jiuwenswarm/tree/main/resources/agent/workspace/skills/swarmskill-creator
Command: npx skills add https://github.com/DreamMacer/jiuwenswarm --skill swarmskill-creator-dreammacer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building a multi-agent team skill by hand is error-prone: roles overlap, quality gates get skipped, and frontmatter contracts drift out of sync with dependency files. This Skill encodes the Swarm Skill specification into a staged authoring pipeline with templates, decision trees, and an automated validator. ## Core Features & Use Cases - Three operation modes: CREATE a new multi-role team from scratch, CONVERT an existing single-agent skill into a collaborating team, or MODIFY an existing Swarm Skill and re-validate it. - Pattern selection guidance: decision trees for adversarial, parallel-decomposition, pipeline, and debate team patterns, with anti-convergence role design rules. - Automated validation: a validator script checks structure, frontmatter, cross-file consistency, and SwarmFlow script safety before a skill is declared done. - Use Case: Convert a single-agent PR review skill that role-plays three personas into a true parallel adversarial review team with isolated roles, quality gates, and a validated dependencies.yaml. ## Quick Start Ask the agent to create a Swarm Skill for your multi-role task, for example: build a three-role adversarial PR review team using the swarmskill-creator workflow.

Frequently Asked Questions about swarmskill-creator

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

FAQPage Schema
How do I create a multi-agent team skill?▼

Use the CREATE mode: confirm the Stage 0 justification for why a single agent fails, pick a pattern (adversarial, parallel, pipeline, or mixed), write role files from the templates, then author workflow.md, bind.md, and dependencies.yaml before running the validator script.

How do I convert a single-agent skill into a multi-role team?▼

Use CONVERT mode, which decomposes the source skill by finding embedded personas, sequential stages with quality gates, and branching checklists. Each persona becomes a role, and the conversion guide maps source content into role files, workflow, and bind constraints.

When should I use a Swarm Skill instead of a single-agent skill?▼

Only when a single agent has adversarial blind spots, the task splits into independent parallel sub-tasks, or sequential stages need hard quality gates. If none apply, a single-agent skill is cheaper in tokens, wall-clock, and authoring effort.

What files does a valid Swarm Skill require?▼

The full Markdown spec requires five files: SKILL.md, roles/ directory, workflow.md, bind.md, and dependencies.yaml. A script-only SwarmFlow variant requires just SKILL.md plus scripts/workflow.py, with roles omitted from the frontmatter.

Why does the Swarm Skill validator fail on my skill?▼

Common causes are missing mandatory files, role filenames not matching roles[].id in frontmatter, descriptions exceeding limits, or roles[].skills declared in SKILL.md but absent from dependencies.yaml. Run validate_swarmskill.py to get file:line references for each failing check.