# cogapp Markdown

> Use when README sections such as CLI help output should be generated from code.

Use cogapp to auto-generate sections of markdown documentation by embedding Python code that produces content. Use when a project needs to keep documentation in sync with code, such as embedding CLI --help output in README files, generating tables, or any content that should be derived from the code itself rather than manually maintained.

## Facts

- Type: Agent skill
- Discipline: Engineering
- Author: Simon Willison (https://github.com/simonw)
- Upstream: https://github.com/simonw/skills/blob/main/cogapp-markdown/SKILL.md
- Source file: https://raw.githubusercontent.com/simonw/skills/main/cogapp-markdown/SKILL.md (4631 bytes, sha256:23f383af74601b7a79a22da38147f4328894363b9a295ebcb70a50637d2c074c)
- Licence: none declared by the repo
- Upstream copy last changed: 2026-09-17
- Status: listed, not yet ruled on by the curator

## Use it

I want to use the cogapp Markdown skill by Simon Willison.
This is what it does, in the author's own words: Use cogapp to auto-generate sections of markdown documentation by embedding Python code that produces content. Use when a project needs to keep documentation in sync with code, such as embedding CLI --help output in README files, generating tables, or any content that should be derived from the code itself rather than manually maintained.
Download the whole folder at https://github.com/simonw/skills/tree/main/cogapp-markdown, SKILL.md and every file beside it, into your skills directory: ~/.claude/skills/cogapp-markdown/ for Claude Code, ~/.agents/skills/cogapp-markdown/ for Codex, ~/.cursor/skills/cogapp-markdown/ for Cursor. Get it from the author's repo, not from startupskills.dev.
Then tell me the path you installed it to and how to invoke it.

Nothing here is vendored: install from the author's repo. This file carries none of the author's file.

## Links

- Page: https://startupskills.dev/simonw/cogapp-markdown
- Author: https://startupskills.dev/simonw
- Index: https://startupskills.dev/llms.txt

## The file

Not reproduced here: the repo does not license republication. Read it on the author's GitHub:
https://github.com/simonw/skills/blob/main/cogapp-markdown/SKILL.md