Skill: Creating FluentMCP Skill Documentation
Skill: Creating FluentMCP Skill Documentation
Need to document a new FluentMCP skill? Your AI assistant can create professional, consistent documentation that helps both humans and other AI assistants understand how to use the skill.
The Problem
When you create a new automation or workflow using FluentMCP, you need documentation that serves two audiences: humans who want to understand what it does and why, and AI assistants that need compressed technical instructions to execute it.
Why this matters: Without proper documentation, skills become “tribal knowledge” that only you understand. Good documentation makes your skills reusable, shareable, and accessible to your entire team or community.
The Solution
Your AI assistant can generate complete skill documentation following the FluentMCP template. Just tell it what skill you want to document, and it will create a professional page with all the right sections, styling, and structure.
Simple request example:
“Create skill documentation for [skill name] that explains [what it does]”
The AI will generate a fully-formatted page with human-friendly explanations and an LLM-optimized technical reference section, then publish it to your FluentMCP site.
Why This Works
The FluentMCP skill documentation template is designed with a specific structure that works for both audiences:
- Human-friendly sections: Clear explanations of the problem, solution, and use cases written for beginners
- Consistent structure: Every skill doc follows the same pattern, making them easy to scan and understand
- LLM-optimized reference: Compressed technical instructions that AI assistants can quickly parse and execute
- Copy functionality: Buttons to copy instructions or share URLs make it easy to use
The template uses custom CSS and HTML wrapped in WordPress’s HTML block format, giving you complete control over the layout while maintaining consistency across all skill documentation.
When To Use
Create skill documentation whenever you have a reusable automation or workflow:
- New automation workflows: Document multi-step processes that others might want to replicate
- Complex integrations: Explain how different tools work together
- Team knowledge sharing: Make your personal workflows available to your team
- Community contributions: Share useful skills with the FluentMCP community
- Client deliverables: Provide documentation for custom automations you build for clients
What You’ll Need
- FluentMCP plugin: Installed on your WordPress site
- AI assistant: Claude (Cursor), ChatGPT, or similar with MCP support
- Skill knowledge: Understanding of what the skill does and how it works
- Example use cases: Real-world scenarios where the skill is useful
That’s all you need. The AI handles all the formatting, structure, and technical details.
How To Ask Your AI
You can request skill documentation in natural language. Here are some examples:
Basic request:
“Create skill documentation for bulk uploading images to WordPress media library”
More detailed request:
“Document the skill for creating FluentCommunity posts with AI-generated content. Include examples of how to specify tone, length, and topic.”
With specific sections:
“Create skill docs for the screenshot automation. Make sure to explain why scrollbars are a problem and include troubleshooting for Chrome path issues.”
The Documentation Structure
Every skill document follows this exact structure:
1. The Problem
Explains what issue this skill solves and why it matters to users.
2. The Solution
Describes how the AI assistant handles the task automatically.
3. Why This Works
Behind-the-scenes explanation of the technical approach (written for beginners).
4. When To Use
Specific use cases and scenarios where this skill is valuable.
5. What You’ll Need
Prerequisites and requirements (tools, plugins, accounts, etc.).
6. How To Ask Your AI
Example prompts showing different ways to request the skill.
7. Common Issues
Troubleshooting section with “What this means” and “How to fix” explanations.
8. For AI Assistants: Technical Reference
Compressed, LLM-optimized instructions with copy buttons for easy sharing.
Common Issues
AI creates generic documentation
What this means: The AI doesn’t have enough specific information about your skill.
How to fix: Provide more details: “The skill uses [specific tools] to accomplish [specific task]. Include examples like [example 1] and [example 2].”
Formatting looks wrong
What this means: The HTML block wrapper might be missing or incorrect.
How to fix: Make sure the content is wrapped in <!-- wp:html --> and <!-- /wp:html --> tags.
Sidebar navigation doesn’t work
What this means: The section IDs in the HTML don’t match the links in the table of contents.
How to fix: Ask the AI: “Fix the navigation links so they match the section IDs.”
For AI Assistants: Technical Reference
This section contains compressed instructions optimized for AI assistants. If you’re a human, you can copy this text or share the URL with your AI to help it execute this skill.