Skills

New Feature Design

Design and document new features with GitHub issue, low-level design (LLD), expert...

Install

npx skills add agentic-community/mcp-gateway-registry --skill new-feature-design -g -a claude-code -y
Category
Design
Updated
3d ago
License
Apache-2.0
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Design and document new features with GitHub issue, low-level design (LLD), expert review, and testing plan. Creates structured documentation in .scratchpad/ with issue spec, technical design with diagrams and pseudo-code, multi-persona expert review, and a testing plan covering functional (curl and registry_management.py), backwards-compatibility, UX, ECS/terraform, and E2E API tests. Supports starting from a user description OR an existing GitHub issue URL. Folder naming: issue-{number}/ for existing issues, {feature-name}/ for new features.

New Feature Design Skill

Use this skill when the user wants to design a new feature for the MCP Gateway Registry. This skill creates comprehensive design documentation that enables entry-level developers to implement the feature.

Input Modes

This skill supports two input modes:

  1. User Description Mode - User describes the feature they want to design
  2. GitHub Issue URL Mode - User provides a URL to an existing GitHub issue

Detecting Input Mode

When the user invokes this skill:

  • If they provide a GitHub issue URL (e.g., https://github.com/owner/repo/issues/123), use GitHub Issue URL Mode
  • Otherwise, use User Description Mode

Workflow

User Description Mode Workflow

  1. Gather Requirements - Ask clarifying questions about the feature
  2. Quick Codebase Review - Explore the codebase to understand structure
  3. Create Design Folder - Create .scratchpad/{feature-name}/ directory
  4. Write GitHub Issue - Create github-issue.md for issue creation
  5. Deep Codebase Analysis - Thoroughly explore relevant code
  6. Write Low-Level Design - Create lld.md with technical details
  7. Expert Review - Create review.md with multi-persona feedback
  8. Write Testing Plan - Create testing.md with functional, backwards-compat, UX, ECS, and E2E tests
  9. Render HTML - Generate a styled .html for each document with scripts/render-doc-html.py
  10. Present Summary & Seek Guidance - Present findings and ask for direction
Read the whole SKILL.md on GitHub

More in Design