Skill

12 Factor App

The Twelve-Factor App methodology for building scalable, maintainable cloud-native applications. Use when designing backend services…

Type: Skill
Repository: pproenca/dot-skills
GitHub stars: 211
License: MIT
Repo last updated: Aug 15, 2026
Source file: README.md

What 12 Factor App is

12 Factor App is a skill published in the pproenca/dot-skills repository on GitHub, which has about 211 stars. The repository describes itself as: “A collection of AI agent skills following the Agent Skills open format”

A skill is a folder with a SKILL.md file: frontmatter with a name and a description, followed by instructions Claude follows. Claude loads a skill automatically when a task matches its description, and you can also run it directly with a slash and its name.

Skills work in Claude Code and in Claude Cowork, which makes 12 Factor App a portable way to give Claude the same method everywhere.

How to install 12 Factor App

Claude Code

Download the 12-factor-app folder from the repository.
Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project.
Claude loads it automatically when a task matches; you can also run it with / and its name.

Claude Cowork

Zip the skill folder so SKILL.md sits at the top level of the folder.
Open Customize → Skills, click +, then upload the ZIP.
Start a task that matches the description, or call it by name with /.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from README.md, shared under the repository's MIT license. Read the full file on GitHub.

A collection of AI agent skills following the Agent Skills open format. These skills extend AI coding agents with specialized capabilities and domain knowledge.

Available Skills

Curated Skills

Experimental Skills

Installation

Install skills using Vercel's add-skill CLI:

# Install all skills
npx add-skill pproenca/dot-skills

# List available skills
npx add-skill pproenca/dot-skills --list

# Install a specific skill
npx add-skill pproenca/dot-skills --skill <skill-name>

# Install globally (across all projects)
npx add-skill pproenca/dot-skills --global

Supported Agents

Skills are installed to agent-specific directories:

Creating Skills

See CONTRIBUTING.md for guidelines on creating new skills.

Quick Start

Copy the template: cp -r skills/.template skills/my-skill
Rename the template file: mv skills/my-skill/SKILL.md.template skills/my-skill/SKILL.md
Edit SKILL.md with your skill's frontmatter and instructions
Add scripts, references, or assets as needed
Test with npx add-skill . --list

Skill Structure

skills/
├── my-skill/
│   ├── SKILL.md          # Required: Skill definition and instructions
│   ├── scripts/          # Optional: Executable scripts
│   ├── references/       # Optional: Additional documentation
│   └── assets/           # Optional: Static resources
├── .curated/             # Vetted, production-ready skills
├── .experimental/        # Work-in-progress skills
└── .template/            # Skill template (SKILL.md.template)

License

MIT

Before you install

Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
Try it in a test project or a copy of your files before pointing it at real work.
Pin the version you tested, and review changes before updating.
Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is 12 Factor App?

12 Factor App is a skill for Claude Code and Claude Cowork from the pproenca/dot-skills repository on GitHub. The Twelve-Factor App methodology for building scalable, maintainable cloud-native applications. Use when designing backend services…

How do I install 12 Factor App in Claude Code?

Download the 12-factor-app folder from the repository. Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project. Claude loads it automatically when a task matches; you can also run it with / and its name.

Can I use 12 Factor App in Claude Cowork?

Zip the skill folder so SKILL.md sits at the top level of the folder. Open Customize → Skills, click +, then upload the ZIP. Start a task that matches the description, or call it by name with /.

Is 12 Factor App safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under MIT. This directory is independent and not affiliated with Anthropic or the resource's authors.