software-factory — Claude Code skill: what it does, how to install
software-factory is a Claude Code skill that establishes a strict architectural vocabulary for agentic coding factories. Organizes services into slots and breaks workflows into isolated task runs.
AGPL-3.0 ★ 88 updated 2026-11-17
npx skills add alexj11324/Mikka --skill software-factory -a claude-codeWhat software-factory does
The skill standardizes system design for autonomous development setups where agents convert issue tickets and pull requests into merged code. It eliminates vague terms such as workflow, sandbox, or dispatch. The architecture relies on specific concepts: Task, Trigger, Run, and Runner.
Designs separate generic service slots from the custom tasks moving between them. Slots cover the ticket tracker, ticket source, git host, orchestrator, and observability platform. To prevent uncontrolled agent output, the framework mandates clear brakes: deterministic automated tests, cold automated diff review, and human sign-off before merge. Runs execute on ephemeral machines and never pause to wait for live human input.
Frontmatter specifies disable-model-invocation: true. The assistant will not activate the skill during ordinary coding tasks, applying it only when whiteboarding factory architecture. Completing a design requires resolving five questions per task: its trigger, service read/writes, next actions, human re-entry point, and concurrency safeguards.
What it helps with
- Design an autonomous agent pipeline for handling issues and pull requests
- Map infrastructure components into standardized service slots
- Implement tiered guardrails with tests, agent review, and human sign-off
- Prevent redundant runs and duplicate ticket creation across runners
Example prompts for the agent
- Design a software factory architecture using Linear and ephemeral runners
- Help me map out the tasks and triggers for an automated PR review loop
- Review my agent pipeline design against the software-factory terminology
How to install software-factory
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill software-factory -a claude-code2Manually: put the files in place
~/.claude/skills/software-factory/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/software-factory/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill software-factory -a codex2Manually: put the files in place
.agents/skills/software-factory/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill software-factory -a cursor2Manually: put the files in place
.cursor/skills/software-factory/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexj11324/Mikka .claude/skills/software-factory2Manually: put the files in place
.github/skills/software-factory/SKILL.md1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill software-factory -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/software-factoryManually: put the files in place
.devin/skills/software-factory/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about software-factory
How to install software-factory in Claude Code?
Run npx skills add alexj11324/Mikka --skill software-factory -a claude-code. Alternatively, place the skill file directly at ~/.claude/skills/software-factory/SKILL.md.
What does software-factory do?
It provides a terminology system and design methodology for building agentic software pipelines. It maps out service slots, isolated runner executions, and mandatory review checkpoints.
Why does software-factory include disable-model-invocation?
The frontmatter sets disable-model-invocation: true so the assistant does not inject factory whiteboarding rules into routine requests unless explicitly asked.