Provides patterns for embedding Python code inside markdown using cogapp (nedbat/cog) so generated content — tables, CLI --help output, code examples — is produced inline and kept up to date. It documents how to write cog blocks, run cog to regenerate content, and integrate checks into CI.
Use this when your project has documentation that should be derived from code (CLI help, auto-generated tables, example outputs) and you want to ensure docs are always consistent with the codebase. Also useful for CI steps that fail when docs are stale.
cog -r, cog --check, and CI integration patterns.Agents that can run Python and file operations (e.g., Copilot-like agents, local automation agents, CI runners).
Cogapp-markdown is a documentation automation skill that embeds Python via cogapp to auto-generate markdown sections like CLI help output and tables. No bundled scripts to test. SKILL.md is well-structured with clear install instructions, syntax reference, key patterns for Click and argparse, and CI integration guidance. Clean from a security perspective — no remote execution, credentials, or destructive patterns.
Solid documentation-oriented skill. The subprocess.run example for argparse CLIs is fine in context (only capturing --help output). No security concerns.
