2

    api-designer-pro

    by Julian

    Expert API architect to design, review, and audit REST, GraphQL, and event-driven API specifications.

    Updated Jun 2026
    86 views
    Security scanned

    $12

    · or 60 credits

    30-day refund guarantee

    Secure checkout via Stripe

    Included in download

    • Generate complete REST specifications with endpoints, schemas, and error codes.
    • Audit an existing API design to identify architectural smells and security gaps.
    • file_read, file_write automation included
    • Ready for Works with VS Code
    • Instant install

    Sample input

    I need an API for a task management app. Users can create projects, add tasks to projects, and mark tasks as complete. Tasks can be assigned to users.

    Sample output

    API DESIGN SPECIFICATION ════════════════════════════════════════ API Name: Task Manager API Version: v1 Base URL: /api/v1 Auth: Bearer JWT ════════════════════════════════════════

    ENDPOINTS ────────────────────────────────────────────────────────────────── [RESOURCE: projects]

    GET /projects List user's projects POST /projects Create project Body: { name: string, description?: string } Response: 201 { id, name, created_at }

    GET /projects/{id} Get project with task summary PATCH /projects/{id} Update project name/description DELETE /projects/{id} Delete project (cascades to tasks)

    [RESOURCE: tasks — nested under projects]

    GET /projects/{id}/tasks List tasks in project Query: ?status=open|complete&assignee_id=&limit=&cursor= [... abbreviated ...]

    About This Skill

    Professional API Architecture & Design

    Designing robust, scalable, and secure APIs is a complex task that requires more than just listing endpoints. API Designer Pro serves as your virtual API architect, helping you design, review, and critique REST, GraphQL, and event-driven architectures using industry-standard patterns.

    What it does

    • Architectural Design: Converts high-level feature requirements into detailed API specifications including endpoints, schemas, and relationships.
    • Design Audits: Analyzes existing designs for "smells" like improper resource naming, incorrect HTTP verb usage, or lack of idempotency.
    • Multi-Paradigm Support: Provides specialized templates and rule-sets for RESTful resources, GraphQL types/resolvers, and asynchronous Event-Driven systems.
    • Safety & Security: Automatically generates a security checklist and error catalog tailored to your specific design.

    Why use this skill

    Generic LLM prompts often produce "CRUD-dy" APIs that ignore production realities like pagination, versioning, and status code semantics. This skill enforces strict architectural principles—such as cursor-based pagination and resource-oriented URI structures—ensuring your API is ready for public consumption or enterprise integration. It provides structured, developer-ready documentation that can be immediately converted into OpenAPI specs or code.

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Read Files
    Write Files

    Tags

    api
    api-design
    architecture
    backend
    designer
    developer-tools
    graphql
    pro
    rest-api
    software-engineering

    Works with VS Code/GitHub Copilot, Cursor, OpenAI Codex, Google Antigravity, Claude Code, and any agent supporting the AgentSkills open standard. Install at .agents/skills/api-designer-pro/SKILL.md.

    Creator

    Julian

    Building AI skills that encode proven frameworks. Each skill distills industry standards into triggerable workflows for developers and founders. I package battle-tested mental models into AI skills. Hope you like my skills. Much love from Germany, Julian <3

    Frequently Asked Questions

    Learn More About AI Agent Skills

    More Premium Skills

    inline-comment

    inline-comment

    Best way to steer your agents, effortlessly.

    $9.994 installs

    designing-hybrid-context-layers

    Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.

    $1015 installs

    ai-automation-qa-pack

    Professional QA & UAT documentation generator for AI automation agencies and complex agent deployments.

    $59 installs

    Bounty Security Pattern Master Library — 399 Vulnerability Patterns

    A premium library of 399 vulnerability patterns and DeFi attack vectors for AI-driven bug hunting and security audits.

    $758 installs

    $12