12 factor agents
Skill Just-Agent/just-product-factor/skills/12-factor-agents
Reusable Factor Skills for Agent-native product optimization
npx -y skills add Just-Agent/just-product-factor --skill 12-factor-agentsAssembled 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.9 KB, as published. Nobody here has run it
12-factor-agents Skill
Name
12-factor-agents
Purpose
Audit and refactor LLM Agent systems for reliability, control, context discipline, tool safety, human-in-the-loop behavior, and production readiness.
When to use
- Agent runtime design
- Tool calling workflows
- Memory and state handling
- Human approval loops
- Long-running task control
- Agent productization
When not to use
- Static HTML polish only
- Pure CI configuration with no Agent logic
- General app deployment where no Agent exists
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
- Prompt and instruction boundaries
- Context engineering
- Tool contracts
- Control flow
- State and memory
- Human-in-the-loop
- Observability
- Error recovery
- Evaluation
- Release readiness
Refactor priorities
- Make the Agent behavior explicit
- Make tools safe and typed
- Make state inspectable
- Add evaluation and traces
- Improve docs and examples
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.