What is Sybil used for in Claude Code?

Sybil is used to parse and execute code examples within documentation and docstrings to ensure they are correct and bug-free during the development process.

How do I handle setup code that shouldn't be visible to readers?

Sybil allows 'invisible code blocks' using HTML comments to run necessary setup logic without displaying it in the rendered documentation.

Can I skip specific code blocks in my documentation?

Yes, Sybil supports skip directives like to bypass examples that are illustrative but not meant for execution.

Does Sybil work with existing pytest suites?

Yes, Sybil is designed to integrate seamlessly with pytest via conftest.py, allowing you to run documentation tests alongside your standard unit tests.

Sybil Documentation Testing

Name: Sybil Documentation Testing
Author: anam-org

byanam-org

•

Security & Testing

Validates and executes code examples within documentation and docstrings using pytest to ensure technical accuracy.

Sybil is a specialized skill that enables the automated verification of code snippets embedded in Markdown files and Python docstrings. By integrating directly with the pytest framework, it parses, executes, and tests these examples to ensure that documentation never goes out of sync with the actual codebase. It provides advanced features like namespace isolation, invisible setup blocks, and conditional skip directives, making it an essential tool for maintaining high-quality technical guides and library documentation.