Does it require a specific file format?

Yes, it is designed to work with Markdown (.md) files that use footnote-style citations ([^N]) and specific session-based definitions.

What does 'provenance health' mean in this context?

Provenance health refers to the traceability of information. This skill ensures that every statement in your documentation can be traced back to a specific session transcript or source file.

How does the skill validate citations?

It parses footnote definitions using the 'session:prefix:line' format and checks if the corresponding JSONL file exists in either the archive or local project directories, verifying the line count matches.

Can I exclude certain folders from the health check?

By default, the skill excludes directories like .git, node_modules, papers, and articles to focus only on core convention documentation.

Brain-OS Documentation Health Checker

Name: Brain-OS Documentation Health Checker
Author: rasha-hantash

byrasha-hantash

0•

Aprendizaje y Documentación

Scans brain-os convention documentation to ensure citation integrity and identifies uncited content for better provenance.

The Brain-OS Doctor skill is a specialized utility designed to maintain the integrity of documentation within the brain-os ecosystem. It performs a comprehensive 'provenance health check' by scanning Markdown convention files to identify sections lacking required citations and validating existing footnotes. By cross-referencing footnote definitions against local and archived JSONL session transcripts, it ensures that every claim is accurately linked to its source transcript, line number, and character offset. This is essential for researchers and developers using brain-os who require a verifiable and high-quality knowledge base.

Características Principales

01Verifies line number accuracy and character offsets for citation precision

02Generates structured health reports with Warning and Info severity levels

03Identifies uncited Markdown sections to highlight potential gaps in source attribution

04Supports customizable directory exclusion for focused documentation audits

05Validates session footnotes against local and archived JSONL transcript files

060 GitHub stars

Casos de Uso

01Maintaining high provenance standards in brain-os convention files

02Validating the link between documentation and historical session transcripts

03Auditing personal knowledge bases for missing or broken source citations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rasha-hantash/dotfiles doctor

For use in Claude.ai and ChatGPT