Crush Configuration
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns
$ npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install alirezarezvani/claude-code-skill-factory agent-factory --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/generated-skills/agent-factory .claude/skills/agent-factory && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "agent-factory" agent skill from https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factory into .claude/skills/agent-factory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-factory", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factoryType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install alirezarezvani/claude-code-skill-factory agent-factory --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .agents/skills && cp -r skills-src/generated-skills/agent-factory .agents/skills/agent-factory && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "agent-factory" agent skill from https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factory into .agents/skills/agent-factory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-factory", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install alirezarezvani/claude-code-skill-factory agent-factory --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/generated-skills/agent-factory .cursor/skills/agent-factory && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "agent-factory" agent skill from https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factory into .cursor/skills/agent-factory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-factory", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/alirezarezvani/claude-code-skill-factory.git --path generated-skills/agent-factory--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install alirezarezvani/claude-code-skill-factory agent-factory --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/generated-skills/agent-factory .gemini/skills/agent-factory && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "agent-factory" agent skill from https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factory into .gemini/skills/agent-factory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-factory", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install alirezarezvani/claude-code-skill-factory agent-factoryInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .github/skills && cp -r skills-src/generated-skills/agent-factory .github/skills/agent-factory && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "agent-factory" agent skill from https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factory into .github/skills/agent-factory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-factory", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install alirezarezvani/claude-code-skill-factory agent-factory --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/alirezarezvani/claude-code-skill-factory.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/generated-skills/agent-factory .opencode/skills/agent-factory && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "agent-factory" agent skill from https://github.com/alirezarezvani/claude-code-skill-factory/tree/dev/generated-skills/agent-factory into .opencode/skills/agent-factory/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-factory", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
agent-factoryClaude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns
Agent Factory is an agent skill from alirezarezvani/claude-code-skill-factory. Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files (for example `HOW_TO_USE.md`, `agent_generator.py` and `expected_output.json`).
It sits in Agent Workflows, covering MCP servers and Subagents. It works with Bash. The repository describes itself as: Claude Code Skill Factory — A powerful open-source toolkit for building and deploying production-ready Claude Skills, Code Agents, custom Slash Commands, and LLM Prompts at… The licence is MIT.
6 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit ba18b31. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships script files (Python), which the agent can run.
Shell commands in SKILL.md call:
npmFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Agent Factory loads about 2k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 686 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from alirezarezvani/claude-code-skill-factory at commit ba18b31, republished under its MIT licence (© alirezarezvani). 686 words, ~2,037 tokens.
.claude/skills/agent-factory/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.A comprehensive system for generating production-ready Claude Code agents and sub-agents. This skill provides templates, standards, and generation tools to create custom agents that seamlessly integrate with Claude Code's agent system.
This skill helps you create custom Claude Code agents for any domain or workflow. It generates properly formatted agent files that Claude Code can automatically discover and invoke when relevant.
Every generated agent includes rich metadata:
---
name: agent-name-kebab-case
description: When to invoke this agent
tools: Read, Write, Edit # Comma-separated
model: sonnet # sonnet|opus|haiku|inherit
color: green # Visual categorization
field: frontend # Domain area
expertise: expert # beginner|intermediate|expert
mcp_tools: mcp__playwright # MCP integrations
---Development: frontend, backend, fullstack, mobile, devops
Quality: testing, security, performance
Strategic: product, architecture, research, design
Domain: data, ai, content, finance, infrastructure
AGENT_NAME: my-custom-agent
DESCRIPTION: What this agent does and when to invoke it
DOMAIN_FIELD: frontend
TOOLS_NEEDED: Read, Write, Edit, Bash.claude/agents/ or ~/.claude/agents/@agent-factory
Create a custom agent:
Name: api-integration-specialist
Type: Implementation
Domain: backend
Description: API integration expert for third-party services
Capabilities: OAuth, REST clients, error handling
Tools: Read, Write, Edit, Bash
MCP: mcp__githubOutput: Complete .claude/agents/api-integration-specialist.md file
Each generated agent is a single Markdown file:
---
name: custom-agent
description: Triggers auto-invocation
tools: Read, Write, Edit
model: sonnet
color: green
field: backend
expertise: expert
mcp_tools: mcp__github
---
You are a [role] specializing in [domain].
When invoked:
1. [Step 1]
2. [Step 2]
3. [Step 3]
[Detailed instructions]
[Checklists]
[Best practices]
[Output format]1. product-planner → Creates requirements
2. frontend-developer + backend-developer → Build (parallel)
3. test-runner → Validates (sequential)
4. code-reviewer → Reviews (sequential)1. debugger → Analyzes issue
2. [appropriate-dev-agent] → Fixes
3. test-runner → Validates fix1. code-reviewer → Quality review (can run solo)
2. security-auditor → Security scan (can run solo)Common MCP servers to integrate:
Agents automatically reference MCP tools in their capabilities when configured.
Agents consume system resources. Monitor with:
ps aux | grep -E "mcp|npm|claude" | wc -lSafe ranges:
Warnings:
30: Reduce parallelization
60: Critical - restart system
✅ Safe: 4-5 strategic agents in parallel ✅ Safe: 2-3 implementation agents coordinated ❌ Unsafe: Quality agents in parallel (crashes system)
Generated Agent Files:
Place in one of these locations:
Project agents (shared with team):
.claude/agents/custom-agent.mdPersonal agents (available everywhere):
~/.claude/agents/custom-agent.mdCreate custom agents for:
Use the AGENTS_FACTORY_PROMPT.md template when:
Version: 1.0.0 Last Updated: October 22, 2025 Compatibility: Claude Code (agents system) Template Location: documentation/templates/AGENTS_FACTORY_PROMPT.md
© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 5 other files in generated-skills/agent-factory of alirezarezvani/claude-code-skill-factory.
Open the folder on GitHubat commit ba18b31
Agent Factory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Agent Factory this skillalirezarezvani/claude-code-skill-factory | 880 | — | ~2k | Automated safety check: Pass | MIT | |
| Crush Configurationcharmbracelet/crush | 29k | — | ~3.7k | Automated safety check: Pass | Custom licence | |
| Skill Stocktakeaffaan-m/ECC | 276k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Claude Automation Recommenderanthropics/claude-plugins-official | 38k | 3 repos | ~2.7k | Automated safety check: Notes | Apache-2.0 | |
| CC Workflow Studio AI Editorbreaking-brake/cc-wf-studio | 5.4k | — | ~561 | Automated safety check: Pass | Custom licence | |
| Agent Deckasheshgoplani/agent-deck | 1k | — | ~1.7k | Automated safety check: Pass | MIT |
charmbracelet/crush
Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.
affaan-m/ECC
Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.
anthropics/claude-plugins-official
Scans a codebase and suggests which Claude Code hooks, subagents, skills, plugins and MCP servers fit its stack, without changing any files.
breaking-brake/cc-wf-studio
Creates and edits visual agent workflows in CC Workflow Studio through conversation, with the agent reading and writing the canvas over MCP.
asheshgoplani/agent-deck
agent-deck, the terminal session manager for AI coding agents.
apify/mcpc
Record or regenerate the mcpc demo GIFs (the README hero docs/images/mcpc-demo.gif and the focused tapes in docs/vhs/) with VHS.
alirezarezvani/claude-code-skill-factory
Complete App Store Optimization (ASO) toolkit for researching, optimizing, and tracking mobile app performance on Apple App Store and Google Play Store
alirezarezvani/claude-code-skill-factory
Analyzes, generates, and enhances CLAUDE.md files for any project type using best practices, modular architecture support, and tech stack customization.
alirezarezvani/claude-code-skill-factory
Advanced content and topic research skill that analyzes trends across Google Analytics, Google Trends, Substack, Medium, Reddit, LinkedIn, X, blogs, podcasts, and YouTube to generate data-driven…
alirezarezvani/claude-code-skill-factory
Comprehensive Test Driven Development guide for engineering subagents with multi-framework support, coverage analysis, and intelligent test generation
alirezarezvani/claude-code-skill-factory
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
alirezarezvani/claude-code-skill-factory
Generate production-ready Claude Code hooks with interactive Q&A, automated installation, and enhanced validation.
Works with
Categories
Claude Code agent generation system that creates custom agents and sub-agents with enhanced YAML frontmatter, tool access patterns, and MCP integration support following proven production patterns. Agent Factory is an agent skill from alirezarezvani/claude-code-skill-factory.
Agent Factory fits situations like: tasks that involve MCP servers; tasks that involve Subagents.
Run `npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a claude-code`. Or copy the skill folder (generated-skills/agent-factory in alirezarezvani/claude-code-skill-factory) into .claude/skills/agent-factory in your project. Claude Code loads it when a task matches its description.
Run `npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a codex`. Or copy the skill folder (generated-skills/agent-factory in alirezarezvani/claude-code-skill-factory) into .agents/skills/agent-factory in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-code-skill-factory --skill agent-factory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-factory, .gemini/skills/agent-factory, .github/skills/agent-factory and .opencode/skills/agent-factory in your project.
Going by SKILL.md and its folder, Agent Factory needs Python for the scripts in its folder and the command-line tools its instructions call (npm). Our summary lists: Python 3.
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Agent Factory is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Agent Factory: Crush Configuration (charmbracelet/crush, 29k stars), Skill Stocktake (affaan-m/ECC, 276k stars), Claude Automation Recommender (anthropics/claude-plugins-official, 38k stars) and CC Workflow Studio AI Editor (breaking-brake/cc-wf-studio, 5.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-code-skill-factory, which has 880 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on November 12, 2025.
Source: alirezarezvani/claude-code-skill-factory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.