docs

Manage markdown documentation lifecycle with SEO and Diátaxis standards.

2|Updated Mar 19, 2026

Search Tags:#documentation #markdown #content strategy #technical writing #seo #diátaxis

Ready to run

npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill docs-alex-voloshin-dev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/alex-voloshin-dev/ai-skills/tree/main/.windsurf/skills/docs
Command: npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill docs-alex-voloshin-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a safe, structured environment for editing markdown documentation and public-facing content without the risk of accidentally modifying application source code or configuration files.

Core Features & Use Cases

Role-Based Writing: Automatically applies specific personas like content-writer, seo-engineer, or solution-architect based on the document type.
Content Optimization: Enforces Diátaxis framework standards and provides automated SEO and humanization checks for public content.
Use Case: Use this skill to draft a new technical ADR or a public-facing blog post, ensuring that the output is properly structured, SEO-optimized, and free of AI-generated patterns.

Quick Start

Use the docs skill to draft a new technical design document for the upcoming API refactor.

Frequently Asked Questions about docs

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

FAQPage Schema

How do I structure technical documentation using the Diátaxis framework?▼

To structure technical documentation using the Diátaxis framework, you apply its four modes—tutorials, how-to guides, reference, and explanation—to ensure content serves the correct user intent and maintains technical accuracy.

What is the best way to write SEO-optimized markdown content for public blogs?▼

Writing SEO-optimized markdown content involves applying specialized writing roles and automated SEO guardrails to ensure search engine visibility while removing AI-generated patterns for a natural human tone.

Can I safely edit markdown documentation without modifying application source code?▼

You can safely edit markdown documentation without modifying application source code because this workflow enforces strict adherence to content-writer standards, preventing accidental modifications to source code or infrastructure files.

How do I assign writing roles for different types of content creation?▼

Assigning writing roles for content creation happens automatically based on the document type, applying specific personas like content-writer, seo-engineer, or solution-architect to match the required output style.

Does this documentation workflow support drafting technical design documents like ADRs?▼

This workflow supports drafting technical design documents like ADRs by applying solution-architect roles and content-writer standards to structure the markdown output accurately for architectural decisions.