claudeskills

A collection of high-performance, community-vetted skills and MCP servers for Anthropic's Claude.

The API Design Reviewer is a comprehensive audit tool that analyzes OpenAPI/Swagger specs, GraphQL schemas, and gRPC proto files. It provides a scored report with actionable fix suggestions across 10 critical design dimensions.

• Multi-Format Support: Works with REST (OpenAPI), GraphQL, and gRPC.
• Scored Audit Report: Generates a professional markdown and interactive HTML report.
• Actionable Feedback: Focuses on "Fix X because Y" instead of generic advice.
• Evaluation-Tested: Includes a suite of test cases to ensure auditing accuracy.

api-design-reviewer/
├── SKILL.md             # Logic and prompt instructions
└── evals/
    └── evals.json       # Test cases for benchmarking

If you are using Claude Code or a similar agentic tool:

1. Copy the contents of api-design-reviewer/SKILL.md into your agent's custom skills directory.
2. Trigger the skill by asking: *"Review this API spec..."* or *"Look at this GraphQL schema."*

Quality is a first-class citizen in this repository. Every skill includes an evals/ directory with test prompts and expected outputs. We use these to benchmark the model's performance and ensure the audit logic remains robust.

We welcome contributions! If you have a Claude skill or an MCP server you'd like to share:

1. Fork the repo.
2. Add your skill directory with a SKILL.md and an evals/ folder.
3. Submit a Pull Request.

--- *Created by sharmasundip*