skill-generator

Generate scaffolded swarm skill units with SKILL.md frontmatter and standard directories.

729|67|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/joelhooks/swarm-tools --skill skill-generator-joelhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-generator
Source: https://github.com/joelhooks/swarm-tools/tree/main/packages/opencode-swarm-plugin/global-skills/skill-generator
Command: npx skills add https://github.com/joelhooks/swarm-tools --skill skill-generator-joelhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This meta-skill eliminates guesswork when creating new swarm skills by enforcing the required frontmatter, directory layout, and bundled resources. It ensures any new skill starts from a correctly scaffolded template, reducing errors and onboarding time.

Core Features & Use Cases

  • Generates complete skill scaffolds including SKILL.md, scripts/, references/, and assets/ based on the provided name.
  • Validates frontmatter format and directory structure to meet the repository conventions.
  • Supports rapid creation of new skills for swarm workflows, agent tasks, or experimental modules.

Quick Start

bash scripts/generate-skill.sh <skill-name> [target-directory]

Frequently Asked Questions about skill-generator

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

FAQPage Schema
How do I scaffold a new swarm skill with the correct directory layout and frontmatter?

To scaffold a swarm skill correctly, run the generate-skill.sh script with a skill name and target directory, which creates a ready-to-customize template with validated SKILL.md frontmatter and standard folders.

What is the required directory structure for generating swarm skills?

The required directory structure for generating swarm skills includes a root SKILL.md file containing validated frontmatter, alongside three standard bundled resource folders: scripts, references, and assets.

Can I use this skill generator to bootstrap templates for experimental agent tasks?

Yes, you can use this skill generator to bootstrap templates for experimental agent tasks by creating correctly scaffolded swarm skill units that adhere to repository conventions and reduce onboarding errors.

What's the best way to enforce frontmatter conventions when creating new swarm skills?

The best way to enforce frontmatter conventions when creating new swarm skills is to use a scaffolding generator that automatically validates the required SKILL.md fields and standard directory layout.

Do I need to manually create scripts, references, and assets folders when building a skill?

No, you do not need to manually create scripts, references, and assets folders when building a skill, because the generator outputs a complete scaffold that already includes these bundled resource directories.

Why does my generated skill template fail repository convention checks?

Generated skill templates fail repository convention checks if the SKILL.md frontmatter format is invalid or the directory structure is missing required scripts, references, or assets folders.