Content Preview
# Common API Anti-Patterns and How to Avoid Them ## Introduction This document outlines common anti-patterns in REST API design that can lead to poor developer experience, maintenance nightmares, and scalability issues. Each anti-pattern is accompanied by examples and recommended solutions. ## 1. Verb-Based URLs (The RPC Trap) ### Anti-Pattern Using verbs in URLs instead of treating endpoints as resources. ``` ❌ Bad Examples: POST /api/getUsers POST /api/createUser GET /api/deleteUser/123
How to Use
Recommended: Install to project (local)
mkdir -p .claude/skills
curl -o .claude/skills/api_antipatterns.md \
https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/engineering/api-design-reviewer/references/api_antipatterns.mdSkill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.
Alternative: Clone full repo
git clone https://github.com/alirezarezvani/claude-skillsThen reference at engineering/api-design-reviewer/references/api_antipatterns.md
Related Skills
Conducting Chaos Engineering
This skill enables Claude to design and execute chaos engineering experiments to test system resilience. It is used when the user requests help with failure injection, latency simulation, resource exhaustion testing, or resilience validation. The skill is triggered by discussions of chaos experiment
skill-adapterconducting chaos engineering
by jeremylongshore · plugins-plus-skills
Engineering Features for Machine Learning
This skill empowers Claude to perform feature engineering tasks for machine learning. It creates, selects, and transforms features to improve model performance. Use this skill when the user requests feature creation, feature selection, feature transformation, or any request that involves improving t
skill-adapterengineering features for machine learning
by jeremylongshore · plugins-plus-skills
engineering_metrics
Engineering Metrics & KPIs Guide
c-level-advisorengineeringmetrics
by alirezarezvani · alirezarezvani-claude-skills
cs-senior-engineer
Senior Engineer agent for architecture decisions, code review, DevOps, and API design. Orchestrates engineering and engineering-team skills for technical implementation work. Spawn when users need system design, code quality review, CI/CD pipeline setup, or infrastructure decisions.
agentsseniorengineeragent
by alirezarezvani · alirezarezvani-claude-skills