gitwalter Documentation & Knowledge Operations
This skill covers the workflows used to generate human-readable catalogs, verify link integrity in doc references, analyze workspace files for knowledge gaps, and compile structured workshop materials.
When to Use
Use this skill when updating catalog manifests, checking for dead links across the reference manuals, or scanning the workspace for missing knowledge entries (KIs).
Prerequisites
- Conda environment initialized.
- Access to root markdown directories.
Process
Follow these procedures to build documentation catalogs and analyze reference links.
Generating catalog manifests
Compile all agent, skill, and workflow definitions into catalog.md:
conda run -p D:\Anaconda\envs\cursor-factory python scripts/docs/generate_catalog.py
Verifying reference links
Ensure no broken markdown links exist across the reference directory:
conda run -p D:\Anaconda\envs\cursor-factory python scripts/docs/verify_catalog_links.py
Best Practices
- Verifiability: Run link checks whenever documentation or directories are reorganized.
- Inbox Hygiene: Keep catalogs up-to-date with new tools and agents as they are created.