cs-guide

Write and update developer and user guide documents in project docs directories.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/wildlily1021/XW_Software --skill cs-guide-wildlily1021
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cs-guide
Source: https://github.com/wildlily1021/XW_Software/tree/main/.agents/skills/cs-guide
Command: npx skills add https://github.com/wildlily1021/XW_Software --skill cs-guide-wildlily1021

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Specs record what was built and why, but downstream developers and end users should not read specs—they need role-oriented, publishable guides. This Skill turns specs and code into task-oriented documentation that readers can actually use. ## Core Features & Use Cases - Dual-track documentation: Produces dev-guides (setup, architecture, API reference) in docs/dev/ and user-guides (feature overview, step-by-step operations, FAQ) in docs/user/. - Lifecycle management: Uses YAML frontmatter with draft/current/outdated status, detects existing guides via search to avoid duplicates, and marks stale docs when code changes. - Workflow integration: Triggers proactively after feature acceptance—interface changes prompt dev-guide updates, user-visible changes prompt user-guide updates. - Use Case: After finishing a feature acceptance, the Skill asks whether the interface contract changed, then drafts a dev-guide with quick-start examples and API reference derived from the design spec. ## Quick Start Ask the assistant to write a developer guide for the feature you just finished, and it will draft a structured document in docs/dev/ for your review.

Frequently Asked Questions about cs-guide

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

FAQPage Schema
How do I write a developer guide from a feature spec?▼

Read the spec's terminology and interface contract sections, check docs/dev for existing guides on the same component, then draft using the dev-guide structure: overview, prerequisites, quick start, core concepts, API reference, and common scenarios. Set status to draft until reviewed.

What is the difference between a dev-guide and a user-guide?▼

Dev-guides target contributors and integrators with setup, architecture, and API details, stored in docs/dev. User-guides target end users with feature overviews, step-by-step operations, and FAQs, stored in docs/user. One feature often needs both.

When should documentation be marked as outdated?▼

Mark a guide outdated when the corresponding code has changed but the document has not been updated. Keep the original content with the outdated flag as reference, then write a fresh version rather than silently editing stale material.

Can I store spec details like invariants and test constraints in a guide?▼

No. Guides are publishable documents for external readers and must not contain internal spec content such as implementation hints, invariants, test constraints, or root-cause analysis. Those belong in the codestable spec directory.

How do I avoid creating duplicate guides for the same feature?▼

Search the docs directories with the YAML search tool filtering by doc_type and component before drafting. If an existing guide is found, treat the task as an update: minor edits modify in place, major restructures mark the old one outdated first.