12 factor app
Reusable Factor Skills for Agent-native product optimization
npx -y skills add Just-Agent/just-product-factor --skill 12-factor-appAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.8 KB, as published. Nobody here has run it
12-factor-app Skill
Name
12-factor-app
Purpose
Audit and refactor apps for deployability, configuration, dependency hygiene, observability, release readiness, and user onboarding.
When to use
- SaaS apps
- API services
- Full-stack apps
- CLI apps
- Deployable open-source products
When not to use
- Single prompt templates
- Pure model evaluation with no app surface
- Documents with no runtime
Inputs
Ask for or inspect:
- README and docs
- source files
- examples and recipes
- configuration files
- tests and validation scripts
- CI/CD workflow files
- logs, changelog, release notes, or version history
Workflow
- Identify the project goal and user-facing promise.
- Inspect available files.
- Apply
checklist.md. - Score with
scoring-rubric.md. - Produce an audit report using
audit-report-template.md. - Produce a refactor plan using
refactor-plan-template.md. - Prioritize changes by product value and release readiness.
- Validate changes if the environment allows.
Review dimensions
- Installability
- Configuration
- Dependencies
- Build and runtime scripts
- Logging
- Error handling
- Documentation
- Examples
- CI/CD
- Release process
Refactor priorities
- Make it install and run
- Make configuration clear
- Add smoke tests
- Improve docs/examples
- Add release workflow
Output format
Return:
- Summary
- Scorecard
- Critical findings
- Recommended changes
- Refactor plan
- Validation plan
- Next iteration suggestions
Example calls
See usage-examples.md.
Version
v0.5.0
Agent manifest
This Skill includes a machine-readable skill.json manifest so an Agent can quickly identify triggers, expected inputs, expected outputs, required files, and the review protocol before reading the full markdown pack.