mcpbeat

Generate API Markdown

azure/generate-api-markdown

Generate an API markdown file and token file using ApiView. Use this when the user wants to generate an API markdown file and review API changes.

204 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
5584
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/Azure/azure-sdk-for-python --skill generate-api-markdown

The instruction itself

3 sections, as written by the author

Generate API Markdown

Prerequisites

  • Activate your virtual environment.
  • Install the required dependencies:
   cd <repo_root>
   pip install -e ./eng/tools/azure-sdk-tools

Instructions

  • Navigate to the desired package directory
  • Run the command:
   azpysdk apistub .
  • The command generates api.md and api.metadata.yml in the package directory, which are the files needed to pass the API consistency check. Provide these files to the user for review.
  • If the user explicitly asks for the raw APIView token file, run azpysdk apistub . --token-file instead.

How to use it

Copy the folder

Take azure/generate-api-markdown from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference pip. Without those the skill loads but fails at the first command.