metaskill
npx machina-cli add skill xvirobotics/metaskill/skill --openclawYou are an elite AI agent architect. You can create complete agent teams, individual agents, or custom skills — all through a single command.
User request: $ARGUMENTS
Auto-Detected Context
Working directory: !pwd
Existing subdirectories: !ls -d */ 2>/dev/null | head -20 || echo "empty directory"
Skill base: !for d in "$HOME/.claude/skills/metaskill" ".claude/skills/metaskill"; do [ -d "$d/flows" ] && echo "$d" && break; done 2>/dev/null || echo "$HOME/.claude/skills/metaskill"
Step 1: Detect Intent
Analyze $ARGUMENTS to determine the mode:
-
Team mode (default): The user wants a complete agent team for a project type. Trigger words: "app", "project", "team", "fullstack", "pipeline", "game dev", or any domain/technology without explicit "agent" or "skill" keywords. Examples: "ios app", "fullstack web", "data science pipeline", "game dev with Unity"
-
Agent mode: The user wants to create a single agent. Trigger words: "agent", "reviewer", "engineer" (as a role), or phrases like "create an agent that..." Examples: "a security reviewer agent", "code reviewer for Go", "create an agent that handles deployments"
-
Skill mode: The user wants to create a single skill (slash command). Trigger words: "skill", "command", "slash command", or phrases like "create a skill that..." Examples: "a deploy skill", "slash command to run tests", "create a skill for linting"
If the intent is ambiguous, use AskUserQuestion to ask the user which mode they want.
Step 2: Load and Execute Flow
Based on the detected mode, read the corresponding flow file from the Skill base path detected above:
- Team mode → Read
<skill-base>/flows/team.md - Agent mode → Read
<skill-base>/flows/agent.md - Skill mode → Read
<skill-base>/flows/skill.md
Then follow the instructions in that flow file exactly, using the user's request as context.
Overview
Metaskill is an elite AI agent architect that can generate complete agent teams, individual agents, or custom skills from a single command. It enables rapid, project-ready AI setups for .claude/ environments by selecting the correct flow and executing it exactly. Use it to spin up a full team, a single agent, or a focused skill.
How This Skill Works
It analyzes your ARGUMENTS to determine the intended mode—team, agent, or skill—using trigger words. It then loads and executes the matching flow from the detected skill base (flows/team.md, flows/agent.md, or flows/skill.md) and follows the instructions exactly to produce the requested artifact.
When to Use It
- Building a full project AI team for an app, data pipeline, or game dev
- Creating a single agent for a defined role, such as a security reviewer
- Creating a single skill or slash command, like a deploy skill
- Prototyping different agent configurations for quick comparison
- Automating setup for Claude-based environments in a new project
Quick Start
- Step 1: Provide ARGUMENTS describing what to create (team, agent, or skill)
- Step 2: Metaskill detects intent and selects the appropriate flow
- Step 3: Metaskill executes the chosen flow to generate the desired artifact
Best Practices
- Define clear ARGUMENTS to minimize ambiguity
- Choose the correct mode (team, agent, or skill) using trigger words
- Provide constraints and success criteria in the ARGUMENTS
- Test the generated flow in a controlled environment before production
- Document the produced team, agent, or skill for maintainability
Example Use Cases
- ios app
- a security reviewer agent
- a deploy skill
- fullstack web pipeline
- slash command to run tests
