How does this skill handle existing documentation links?

The skill includes a redirect step that creates README.md files in the original locations to point users and links toward the new intent-based structure, preventing broken links.

What are the four primary categories used by this skill?

Documentation is sorted into BUILD (for implementation), FIX (for troubleshooting), UNDERSTAND (for architecture and system design), and LOOKUP (for quick references and cheat sheets).

What is intent-based documentation?

It is a methodology that organizes documentation based on what a developer is currently trying to achieve—such as fixing a bug or building a feature—rather than organizing by file types or technical layers.

Why organize the FIX directory by symptoms instead of root causes?

When developers are troubleshooting, they know the symptoms they see (like 'slow startup') but don't yet know the root cause; organizing by symptoms makes the relevant guide much easier to find.

Organizing Documentation

Name: Organizing Documentation
Author: cipherstash

bycipherstash

•

Learning & Documentation

Reorganizes project documentation into an intent-based structure to improve discoverability and developer productivity.

This skill transforms disorganized or content-type documentation into a high-performance, intent-based system categorized by developer actions: BUILD, FIX, UNDERSTAND, and LOOKUP. By mapping documentation to specific developer goals and symptoms, it eliminates navigation friction, ensures critical prerequisites are met through a dedicated starting point, and provides lightning-fast references for experienced users. It is particularly effective for scaling teams, onboarding new members, and reducing the time developers spend searching for technical information.

Key Features

01Master INDEX.md creation with mandatory purpose annotations

024 GitHub stars

03Intent-based categorization (BUILD, FIX, UNDERSTAND, LOOKUP)

04Symptom-based organization for troubleshooting and debugging guides

05Automated directory structure generation with numeric sequencing

06Link preservation through automated redirects and transition READMEs

Use Cases

01Improving developer onboarding by creating clear, goal-oriented reading paths

02Restructuring legacy project documentation that has become chaotic or difficult to navigate

03Standardizing documentation for new project kickoffs to ensure long-term maintainability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cipherstash/cipherpowers organizing-documentation

For use in Claude.ai and ChatGPT

Download Skill