repo-website-api-create

Create API reference routes with index.mdx and properties.ts files.

1.1k|32|Updated Apr 5, 2025
One-click install
npx skills add https://github.com/open-circle/formisch --skill repo-website-api-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-website-api-create
Source: https://github.com/open-circle/formisch/tree/main/skills/repo-website-api-create
Command: npx skills add https://github.com/open-circle/formisch --skill repo-website-api-create

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill streamlines creating consistent API documentation routes for new exports in the Formisch website, ensuring every function, type, or component has dedicated docs.

Core Features & Use Cases

  • Template-driven documentation: each API item gets its own folder with index.mdx and a properties.ts to map props.
  • Enforces source-of-truth: docs derived directly from the source code.
  • Supports cross-package linking and component references in a standard structure.

Quick Start

Create a new documentation folder for the API item, add an index.mdx and a properties.ts, and update the site menu to include the new route following the repository's MDX patterns.

Frequently Asked Questions about repo-website-api-create

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API documentation routes from source code for new exports?

To generate API documentation routes, the skill reads your source code to extract interfaces, types, and function signatures, then organizes them into an index.mdx file with frontmatter and a properties.ts file. This ensures every exported function, type, or component has dedicated docs derived directly from the source of truth.

What is the standard MDX structure for adding API reference pages to a website?

The standard MDX structure for API reference pages requires creating a dedicated folder for each API item containing an index.mdx file with frontmatter and a properties.ts file to map props. You then update the site menu to include the new route following the repository's documentation pattern.

How do I document newly exported functions and types that do not yet have website entries?

You document newly exported functions and types by applying a template-driven approach that creates a new folder with index.mdx and properties.ts for each item. The skill automates extracting signatures and interfaces from source code to enforce a consistent documentation structure.

Do I need to manually write frontmatter and properties files when adding API docs?

You do not need to manually write frontmatter and properties files from scratch. The skill automates the creation of these files by extracting interfaces, types, and function signatures from source code, mapping props into properties.ts, and organizing content into index.mdx.

Can I support cross-package linking and component references in my generated API docs?

Yes, the generated API docs support cross-package linking and component references by following the repository's standard documentation pattern. The skill organizes items into index.mdx and properties.ts files, ensuring consistent structure across all new API reference routes.

When should I avoid auto-generating API documentation routes for my website?

You should avoid auto-generating API documentation routes when adding documentation for exports that already have existing website entries. The skill specifically applies only to newly exported functions, types, components, or methods that do not yet have dedicated documentation folders.