devtools

Docsible

Auto documentation for Ansible roles and collections
143 stars33 forksPythonUpdated 8/26/2026100% free · open source
What it does

Automatically creates Markdown documentation for your Ansible roles and collections directly from their source files.

When to use it
  • You have a growing library of custom Ansible roles and need up‑to‑date docs without writing them by hand.
  • Your team shares roles via a Git repository and you want a single command to generate docs for CI/CD pipelines.
  • You need to publish role documentation to an internal wiki or public site and want a reproducible, automated process.
Ready-to-paste prompt
docsible generate ./roles/webserver > ./docs/webserver_role.md
Heads up: docsible relies on the Ansible Python package to parse role metadata, so you must have Ansible installed (e.g., `pip install ansible`) and use Python 3.8 or newer.
Saves to your device
Use with Claude
New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install
Claude Code
mkdir -p ~/.claude/skills/docsible && curl -fsSL https://workflowstacks.com/api/skills/docsible/claude-skill -o ~/.claude/skills/docsible/SKILL.md
Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)
claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How Docsible works
Codeflow
Free to inspect

Docsible is a small Python project (~2.4k lines across 10 code files, plus 6 test files). Setup is light: installs like a normal app. Reading the code is optional. Last commit this month, MIT license, has a test suite.

Size
Small codebase
~2.4k lines · 10 code files · 20 min skim
Setup
One-command install
Installs like a normal app. Reading the code is optional.
Runs on
Python
No API keys detected
Python 100%
Where to start reading
  1. 1
    README.md
    Start here — what it does and how to install it
  2. 2
    docsible/cli.py
    Where the program starts running
  3. 3
    pyproject.toml
    Dependencies and the commands it exposes
  4. 4
    docsible/__init__.py
    Inside docsible/ — the main logic begins here
What's in each folder
docsible/Core code — the actual logic8 files
scripts/Helper scripts1 files
tests/Tests — proof it works11 files
.github/CI / automation (GitHub Actions)4 files
READMEHas testsDocumentedNo CIMIT licenseUpdated this month
Quick Actions
Details
Creator
docsible
Language
Python
Category
devtools
Published
9/5/2023

Are you the creator of this tool? Claim your listing → and earn 85% of every sale.