# New Feature Design

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

- Repository: https://github.com/agentic-community/mcp-gateway-registry (1032 stars)
- Category: Design
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentic-community/mcp-gateway-registry --skill new-feature-design -g -a claude-code -y`
Codex: `npx skills add agentic-community/mcp-gateway-registry --skill new-feature-design -g -a codex -y`
Cursor: `npx skills add agentic-community/mcp-gateway-registry --skill new-feature-design -g -a cursor -y`
Gemini CLI: `npx skills add agentic-community/mcp-gateway-registry --skill new-feature-design -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/agentic-community/mcp-gateway-registry/blob/HEAD/.claude/skills/new-feature-design/SKILL.md