Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/Factory-AI/skills itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 26, 2026Skills
Skills are reusable capabilities that Droids invoke on demand. They pack instructions, expertise, and tools into a lightweight package that teaches the agent how to complete specific tasks in a repeatable way.
Key properties:
- Model-invoked - Droids decide when to use them based on the task, not typed commands
- Composable - Can be chained together as part of larger workflows
- Token-efficient - Lightweight and focused, not bloated with unused tools or repeated instructions
For more information, see the Factory Skills documentation.
About This Repository
This repository contains example skills for Factory's Droid system. These skills demonstrate patterns for common workflows like code review and security analysis.
Each skill is self-contained in its own folder with a SKILL.md file containing the instructions and metadata that Droids use. Browse through these skills to get inspiration for your own or to understand different patterns and approaches.
Where Skills Live
Skills are discovered from well-known locations:
| Scope | Location | Purpose |
|---|---|---|
| Workspace | <repo>/.factory/skills/ | Project skills shared with teammates; checked into git |
| Personal | ~/.factory/skills/ | Private skills that follow you across projects |
Each skill lives in its own directory:
- Workspace:
<repo>/.factory/skills/<skill-name>/SKILL.md - Personal:
~/.factory/skills/<skill-name>/SKILL.md
Quickstart
-
Copy a skill folder from
skills/<skill-name>/to your target location:# For project-wide use cp -r skills/code-review .factory/skills/code-review # For personal use across all projects cp -r skills/security-review ~/.factory/skills/security-review -
Restart
droidso it rescans skills -
Describe your task normally - the Droid will automatically invoke matching skills when they apply
Included Skills
| Skill | Description |
|---|---|
code-review | Review code changes (diffs, PRs, patches) with structured, actionable feedback on correctness, maintainability, and test coverage |
security-review | STRIDE-based security analysis that scans code for vulnerabilities, validates exploitability, and outputs structured findings for patch generation. Supports PR review, scheduled scans, and full repo audits |
Creating a Basic Skill
Skills are simple to create - just a folder with a SKILL.md file containing YAML frontmatter and instructions:
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
# My Skill Name
[Add your instructions here that the Droid will follow when this skill is active]
## Instructions
- Step 1
- Step 2
## Guidelines
- Guideline 1
- Guideline 2
The frontmatter requires only two fields:
name- A unique identifier for your skill (lowercase, hyphens for spaces)description- A complete description of what the skill does and when to use it
Use the template/ folder as a starting point.
Disclaimer
These skills are provided for demonstration and educational purposes. The implementations and behaviors you receive may vary based on context and model capabilities. Always test skills thoroughly in your own environment before relying on them for critical tasks.
License
MIT License - see LICENSE file for details.