new-feature-design SKILL.md skillC

new-feature-design from agentic-community/mcp-gateway-registry is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add agentic-community/mcp-gateway-registry/new-feature-design@v1.6

Pins v1.6 in mdr.lock. Pin the fingerprint instead.

Audit grade
C, 15 of 17 checks passed
Kind
SKILL.md skill
Repository
agentic-community/mcp-gateway-registry
Path
.claude/skills/new-feature-design/SKILL.md
Versions recorded
8
Latest version
v1.6, committed Oct 2, 2026
First version recorded
May 22, 2026
Size
72,974 bytes
Repository stars
1,034
License
Apache-2.0

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add agentic-community/mcp-gateway-registry/new-feature-design@sha256:0c2ff2e2ae814ac3

The line at the top of this page pins the label v1.6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_xjufr6lx2j6gwofj.svg)](https://markdownregistry.com/a/art_xjufr6lx2j6gwofj)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between May 22, 2026 and Oct 2, 2026, about one every 19 days. Its first recorded version is graded A and its latest C.

versioncommittedcommitsizeaudit
v1.6 latest2026-10-02 7e5cb48 72,974 BC view · diff
v1.62026-10-02 a495b8a 72,976 BC view · diff
v1.62026-09-20 4f8325f 67,982 BA view · diff
v1.62026-07-08 ad882d7 66,929 BA view · diff
v1.62026-07-08 59292cd 66,369 BA view · diff
v1.62026-07-06 ce2d2b7 64,979 BA view · diff
v1.62026-06-20 2f73d88 63,666 BA view · diff
v1.62026-05-22 abb97a5 62,443 BA view

Audit of the latest version

C  15 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:8112)
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (72974 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

agentic-community/mcp-gateway-registry · 1,034 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xjufr6lx2j6gwofj
GET https://markdownregistry.com/api/v1/resolve?ref=agentic-community/mcp-gateway-registry/new-feature-design
GET https://markdownregistry.com/api/v1/blob/0c2ff2e2ae814ac3cc12ddc3472556703766a3ceaf62712e4b73a9d65ae8dd9f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from agentic-community/mcp-gateway-registry

agentcore-register SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/agentcore-register/SKILL.md · Given an MCP server URL, probe the server via curl to discover its metadata and tools, then generate a markdown file…
git:20260412.d73bd64 · audit A · 1,034 stars
benchmark-report SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/benchmark-report/SKILL.md · Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON…
v1.0 · audit A · 1,034 stars
create-milestone SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/create-milestone/SKILL.md · Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all…
v2.0 · audit A · 1,034 stars
debug SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/debug/SKILL.md · Debug issues in the MCP Gateway Registry using first-principles thinking. Invoke when something is broken, timing out…
v1.0 · audit A · 1,034 stars
explainer SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/explainer/SKILL.md · Explain a GitHub issue or pull request at 100, 200, and 300 level. Verifies every claim against the code, then writes a…
v1.1 · audit B · 1,034 stars
generate-agent-card SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/generate-agent-card/SKILL.md · Generate an A2A agent card JSON by analyzing agent source code in a folder or GitHub URL. Studies the code to detect…
git:20260406.3e0708d · audit A · 1,034 stars
generate-server-card SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/generate-server-card/SKILL.md · Generate an MCP server card JSON (mcp-gateway-registry format) by analyzing server source code in a folder or GitHub…
git:20260406.3e0708d · audit A · 1,034 stars
infra-sync SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/infra-sync/SKILL.md · Keep Terraform and CDK infrastructure in sync. Compares terraform/aws-ecs/ and infra/ to identify discrepancies in ECS…
v1.0 · audit A · 1,034 stars
macos-setup SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/macos-setup/SKILL.md · Complete macOS setup and teardown for MCP Gateway & Registry (AI-registry). Clones the repository, installs all…
v2.0 · audit C · 1,034 stars
pr-review SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/pr-review/SKILL.md · Review a GitHub pull request using multiple expert personas. Takes a PR URL as input, analyzes the changes, and…
v1.1 · audit C · 1,034 stars
release-notes SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/release-notes/SKILL.md · Create release notes for a new version tag. Gathers all commits, PRs, issues fixed, and breaking changes since a…
v1.0 · audit A · 1,034 stars
search-benchmark SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/search-benchmark/SKILL.md · Generate a search quality benchmark for the AI Registry. Generates ground truth from the registry's assets, runs 100+…
v1.0 · audit A · 1,034 stars

Every file in agentic-community/mcp-gateway-registry

Browse by kind, by grade C, or by owner.