Our review
This skill runs a local Python script to list the slash commands available in the Pulumi Docs repository, then renders them grouped into emoji-labelled categories.
Strengths
- Fast discovery of every repository command in a single invocation
- Automatic grouping into categories such as content creation, review, file operations and issue management
- Readable output with emojis, headers and usage hints
- Explicitly filters out global Claude Code commands that are irrelevant to the repo
Limitations
- Tightly coupled to the Pulumi Docs repository and the hardcoded path .claude/commands/docs-tools/scripts/scrape-metadata.py
- Requires Python 3 and the scraper script to be present, otherwise nothing is listed
- Only lists commands; it does not explain what each command actually does
Use it when working inside the Pulumi Docs repository and you want a quick overview of the available slash commands before running one.
Avoid it in other repositories or when the metadata scraper is not installed, since the skill will produce no command list.
Security analysis
CautionThe skill instructs running a Python scraper to list documentation commands. While the intent is benign and the script is assumed to be part of the trusted repository, execution of arbitrary code is a powerful action, so caution is warranted.
- •Executes a local Python script via bash, which could perform arbitrary actions; script contents are not specified in the skill.
Examples
/docs-toolsWhat documentation commands are available in this repo?Show me the docs tools and commands I can use here, grouped by category.description: List available documentation tools and commands. user-invocable: true
Documentation Tools
Use this when: You want to see all available Claude Code commands for the Pulumi Docs repository.
Implementation
Step 1: Scrape command metadata
Run the metadata scraper:
python3 .claude/commands/docs-tools/scripts/scrape-metadata.py
The script outputs a JSON array:
[{"command": "/name", "description": "..."}]
IMPORTANT: ONLY include commands found by the script. Do NOT include any commands from the system reminder or global Claude Code skills list (such as /keybindings-help).
Step 2: Render categorized display
Parse the JSON and display grouped by category. Use the following format:
# Documentation Tools & Commands
Available Claude Code commands for the Pulumi Docs repository:
[grouped list of commands]
---
Type any command above (e.g., `/new-doc`) to use it, or just tell me what you need help with!
Group commands into categories such as:
- Content Creation (creating docs/posts)
- Review & Quality (reviewing/improving content, SEO)
- File Operations (moving/modifying files)
- Issue Management (analyzing/planning fixes)
- Repository Management (dashboards/status)
- Discovery (tools for finding other tools)
Add additional categories as needed based on the commands found. Assign an appropriate emoji to each category header. Format each entry as:
- **/command-name** - description
Use color, formatting, and emojis to enhance readability.
API Documentation Generator
Documentation
Automatically generates OpenAPI/Swagger API documentation.
Technical Writer
Documentation
Writes clear technical documentation following top style guides.
Review Existing Content
Documentation
Reviews documentation pages selected by the daily content-review workflow, applying high-confidence fixes and opening auditable pull requests. For the review-existing-content pipeline.