docs

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

2|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/alex-voloshin-dev/ai-skills --skill docs-alex-voloshin-dev
Or copy as Structured Prompt for Agent
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.