7 factor mcp

Skill Just-Agent/just-product-factor/skills/7-factor-mcp

Reusable Factor Skills for Agent-native product optimization

Install

npx -y skills add Just-Agent/just-product-factor --skill 7-factor-mcp

Assembled 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.7 KB, as published. Nobody here has run it

7-factor-mcp Skill

Name

7-factor-mcp

Purpose

Audit and improve MCP tools and servers for tool schema clarity, permission boundaries, runtime safety, observability, and user ergonomics.

When to use

MCP servers
MCP clients
Tool integrations
Agent tool layers
Local/remote tool bridges

When not to use

General APIs with no Agent/tool schema layer
Static docs only

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

Tool boundaries
Schema clarity
Permission model
Runtime safety
Error handling
Observability
Developer ergonomics

Refactor priorities

Clarify tool contracts
Reduce unsafe permissions
Improve errors
Add examples
Add validation and logs

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.