SuperAPI AI Directory

update-ignored-endpoints

General & other

View repository

Updated 10-16 07:16

About this skill

Update Ignored Endpoints

This skill updates the IGNORED_ENDPOINTS.md file by analyzing which API endpoints are intentionally not implemented as MCP tools. It auto-discovers all generated API client files to support projects with multiple Orval configurations.

When to Use

Use this skill when:

  • User asks to update the ignored endpoints documentation
  • User wants to verify which endpoints are not implemented
  • User needs to refresh the endpoint coverage analysis
  • Changes have been made to tool implementations and documentation needs updating

Instructions

  1. Run the update script from the consumer project root:
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/update-ignored-endpoints/scripts/update-ignored-endpoints.ts
  1. Review the changes to docs/analysis/IGNORED_ENDPOINTS.md

  2. The script will:

    • Auto-discover all *.ts files in src/umbraco-api/api/generated/ (excluding *.zod.ts and exampleApi.ts)
    • Extract all API endpoint names from Result type exports
    • Compare against implemented MCP tools (files with ToolDefinition + withStandardDecorators)
    • Categorize ignored endpoints using collection names from .discover.json (falls back to "Uncategorized" if no manifest exists)
    • Update the documentation with current ignored endpoints
    • Preserve the rationale sections
    • Update the total count and coverage percentage

Environment Variables

Variable Description Default
PROJECT_ROOT Root of the consumer project .
TOOLS_DIR Path to the tools directory (relative to PROJECT_ROOT) src/umbraco-api/tools
OUTPUT_FILE Path for the output markdown file (relative to PROJECT_ROOT) docs/analysis/IGNORED_ENDPOINTS.md
API_GENERATED_DIR Path to generated API client files (relative to PROJECT_ROOT) src/umbraco-api/api/generated

Supporting Files

The update script is at scripts/update-ignored-endpoints.ts and analyzes all generated API client files and existing MCP tools to generate updated documentation.