cs-onboard

Initialize CodeStable directory skeletons and migrate scattered documentation into structured workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Repositories either lack a structured documentation system or have scattered markdown files with no consistent organization, making it hard for AI-assisted workflows to find and reuse project knowledge. This Skill onboards any repository into the CodeStable system by automatically detecting which path applies and executing it. ## Core Features & Use Cases - Dual-path onboarding: Automatically scans the repository and chooses between creating a fresh skeleton (empty repo) or auditing and migrating existing docs (repo with scattered documentation). - Standard skeleton creation: Builds the full codestable/ directory tree (requirements, architecture, roadmap, features, issues, compound, tools, reference) plus placeholder templates like ARCHITECTURE.md. - Migration with audit report: Generates a confidence-rated mapping table of existing docs to CodeStable locations, asks the user to confirm medium/low-confidence mappings, and never moves or deletes files without approval. - Legacy rename handling: Detects old easysdd/ directories and offers a one-command git mv rename to codestable/. - Use Case: You inherit a repo with a docs/ folder full of design notes. Run this Skill to get an audit report mapping each file to its CodeStable destination, confirm the mappings, and end with a fully structured codestable/ tree ready for feature and issue workflows. ## Quick Start Ask the AI to set up CodeStable in this project by saying "initialize CodeStable in this repository" and it will scan, pick the right path, and build or migrate the structure.

Frequently Asked Questions about cs-onboard

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

FAQPage Schema
How do I set up CodeStable in an existing repository?▼

Run the cs-onboard skill, which first scans the repository for existing markdown docs and any codestable directory. It then either creates a fresh skeleton for empty repos or produces an audit report mapping existing docs to CodeStable locations for your confirmation.

How do I migrate scattered markdown docs into a structured docs system?▼

The migration path generates a confidence-rated table mapping each existing file to a target location under codestable/. High-confidence mappings are listed for review, while medium and low-confidence ones are confirmed with you one by one before anything moves.

Does cs-onboard delete or overwrite my existing documentation?▼

No. Files you choose to skip stay in place untouched, and no file is moved or deleted without your explicit confirmation. The only forced overwrite is codestable/tools/ and codestable/reference/, which are refreshed from the skill package as shared assets.

What happens if my repo has an old easysdd directory?▼

The skill detects easysdd/ (the pre-2026 name of CodeStable) and offers to run git mv easysdd codestable, since the structure and frontmatter are fully compatible. If you decline, it treats the repo as a fresh setup and the old directory is ignored by sub-skills.

Does cs-onboard create the AGENTS.md file automatically?▼

It checks whether AGENTS.md exists at the repo root and reminds you if missing, but does not write its substantive content because that is project-specific. It can offer a minimal template covering code rules, forbidden actions, and known pitfalls for you to fill in.