skills.rest
alexherrero
alexherreroCOMMUNITY
Explore all skills by this author →
GitHub

diataxis-author

Author and maintain Diátaxis-style wikis across multiple repositories.

2|Updated May 13, 2026
Search Tags:#migration#drift-detection#authoring#diataxis#wiki-maintenance#documenter#style-resolver
One-click install
npx skills add https://github.com/alexherrero/crickets --skill diataxis-author
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diataxis-author
Source: https://github.com/alexherrero/crickets/tree/main/src/wiki-maintenance/skills/diataxis-author
Command: npx skills add https://github.com/alexherrero/crickets --skill diataxis-author

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Diátaxis-author skill provides live authoring guidance for maintaining a wiki in the Diátaxis four-mode structure. It orchestrates mode selection, template filling, filename style, drift detection, and one-shot migration, pulling conventions from AgentMemory and composing a base voice overlay for authored drafts. It dispatches a documenter sub-agent for mechanical writes and supports operator-gated drift repair and migration flows.

Core Features & Use Cases

  • Proactive authoring guidance during page creation (mode inference, templates, and naming).
  • Drift detection and repair workflows for wiki content, including mode-mixed detection and template drift checks.
  • One-shot migration from legacy wiki layouts to the Diátaxis four-mode layout with preview-first safety.
  • Global, per-project, and per-repo voice overlays integrated via the style resolver.

Quick Start

Run the diataxis author CLI to scaffold a skeleton page in your wiki with the chosen mode and filename style.

Frequently Asked Questions about diataxis-author

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

FAQPage Schema
How do I migrate a legacy wiki to the Diátaxis four-mode structure?▼

Diátaxis wiki migration converts legacy layouts into the four-mode structure through a one-shot workflow with preview-first safety, ensuring content is reclassified and moved without losing information.

How do I detect and repair content drift in a multi-repository wiki?▼

Drift detection identifies mode-mixed pages and template deviations across repositories, triggering operator-gated repair workflows that dispatch a documenter sub-agent to mechanically rewrite and realign the content.

What is the Diátaxis authoring process for generating new wiki pages?▼

Diátaxis authoring scaffolds new pages by inferring the correct mode, selecting templates, applying filename styles, and composing a base voice overlay, then dispatching a documenter sub-agent for mechanical writes.

Can I apply different voice overlays for specific repositories or projects?▼

The style resolver applies global, per-project, and per-repo voice overlays to customize authored drafts, allowing you to maintain a consistent base voice while adapting tone for specific repositories or projects.

Does wiki authoring with Diátaxis require YAML frontmatter in SKILL.md files?▼

Yes, Diátaxis authoring satisfies integration with YAML-frontmatter SKILL.md files and loads conventions from AgentMemory to ensure generated pages comply with existing structural and metadata standards.

What are the limitations of using automated mode classification for wiki maintenance?▼

Automated mode classification relies on inference but may struggle with mode-mixed content, requiring operator gating for drift repair and migration workflows to prevent misclassification and ensure safe preview-first execution.

Related Skills

Explore More Software Engineering Skills→
erclxerclx
2

create-skill

Generate compliant skill directories and SKILL.md files with validated frontmatter.

Community
Intermediate
ek33450505ek33450505
8

orchestrate

Dispatch agent teams from an Agent Dispatch Manifest in dependency-aware order.

Community
Advanced
amazingloft999-droidamazingloft999-droid
356

git-guardrails-claude-code

Block dangerous git commands on Claude Code repositories via a PreToolUse hook.

Community
Intermediate
RockerMJ031RockerMJ031

mj-lark-meet

Extracts Lark meeting transcripts into Wiki documents and tasks via lark-cli automation.

Community
Advanced