Skip to main content
skill CX Codex

factory-files — Claude Code skill: Warp software factory files

factory-files is a Claude Code skill that authors Warp software factory files in a repo tree rooted at factory.yaml and validates them on the server before a pull request.

AGPL-3.0 ★ 720 updated 2026-11-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dominikmartn/harp --skill factory-files -a claude-code
Open on GitHub

What factory-files does

The skill covers what defines a factory in a repository: factory.yaml, agents/<name>/agent.md, automations, runners, scorers, benchmarks and webhooks. Resource names come from the path, so renaming an agent means moving its directory. The format belongs to warp-server, and no copy of it sits in the skill; the schema for the tree's schemaVersion is pulled from two unauthenticated endpoints, https://app.warp.dev/api/v1/factory-files/schemas and https://app.warp.dev/api/v1/factory-files/schemas/<schemaVersion>.

Before a pull request the bundled scripts/validate_factory_files.py runs on Python 3.8 or newer and hands the tree to the server, which parses it the same way the apply path does. Exit 0 means nothing was reported, 1 means diagnostics to fix, 2 means the tree was not checked at all. Server state stays out of scope: model IDs, environment and secret names, runner names, MCP server IDs, and Linear or Slack aliases are resolved when the plan is applied.

Reaching the Warp server is part of the job. Without it the validator returns 2 and the files stay unchecked. No credential is needed; WARP_API_KEY is forwarded when the environment already carries one and dropped for a single retry on 401 or 403. Sending work to a live factory or reading task status belongs to factory-mcp instead.

What it helps with

  • add an automation to a factory tree
  • edit an agent prompt without touching its frontmatter
  • run the server parser over the tree before a pull request
  • write a scorer rubric into the Markdown body
  • trace a diagnostic after a schema version change

Example prompts for the agent

  • Add an automation that fires whenever a new pull request opens.
  • Validate the factory tree and list every diagnostic it reports.
  • Update the rubric in scorers/review/scorer.md and keep the frontmatter as it is.

How to install factory-files

1Skills CLI (Vercel)

npx skills add dominikmartn/harp --skill factory-files -a claude-code

2Manually: put the files in place

~/.claude/skills/factory-files/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/factory-files/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about factory-files

How do I install factory-files in Claude Code?

Run npx skills add dominikmartn/harp --skill factory-files -a claude-code. The skill lands at ~/.claude/skills/factory-files/SKILL.md.

What does factory-files do?

It writes and edits the file-based definitions of a Warp software factory and checks the tree with the parser the server uses on apply.

What do I need to run factory-files?

Python 3.8 or newer and a reachable Warp server at https://app.warp.dev. No API key is required; an existing WARP_API_KEY is forwarded when present.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set62

The whole set →
triage-vulnerabilities triage-vulnerabilities is a Claude Code skill that pulls vulnerabilities from Dependabot, GCP Artifact Registry, Docker Scout and Linear, then fixes them one at a time. It fires on a request to check CVEs. CX Codex +1 ★ 720repo stars tab-configs tab-configs is a Claude Code skill that documents Warp tab config schemas and checks. It activates while creating or editing tab-config TOML files. CX Codex +1 ★ 720repo stars edit-figma-design The edit-figma-design skill for Claude Code generates and updates Figma designs based on text descriptions. It triggers when tasked with creating interfaces or refining existing Figma files. CX Codex +1 ★ 720repo stars triage-issue-local triage-issue-local is a Claude Code skill for Warp issue triage. It applies repository-specific guidance on top of the core triage-issue skill. CX Codex +1 ★ 720repo stars gui-integration-test-video gui-integration-test-video is a Claude Code skill for recording video and screenshots from Warp GUI integration tests. It applies when creating a test capture or checking its output. CX Codex +1 ★ 720repo stars cross-platform-cloud-verification The cross-platform-cloud-verification skill for Claude Code manages cost-effective cloud testing across multiple operating systems and architectures. It runs for changes with cross-platform impacts. CX Codex +1 ★ 720repo stars review-pr-local review-pr-local is a Claude Code skill that applies Warp repository rules to pull request reviews. It extends the core review-pr skill. CX Codex +1 ★ 720repo stars warpctrl warpctrl is a Claude Code skill that hands the agent a CLI into the Warp app already open on the machine: tabs, panes, the input buffer, themes, settings. Requests about Warp's own windows land here instead of the project tree. CX Codex +1 ★ 720repo stars

Project sponsors

Companies that keep this analytics open