Can I use custom schemas with this skill?

Yes, Synapse uses a schema cascade where local custom schemas in your project directory override the base schemas, allowing for project-specific documentation rules.

How does the skill handle documentation validation?

It uses the 'synapse validate' command to check for YAML frontmatter compliance, required sections, and body-grammar rules that restrict which markdown elements are allowed in specific sections.

What document types does the Synapse skill support?

It supports 15 specific types: ADR, Agreement, Capability, Meeting, Policy, PRD, Process, Reference, Runbook, Scorecard, SOP, SOW, Standard, System, and TDD.

What is a body-grammar rule?

Body-grammar rules define exactly which markdown nodes (like tables, lists, or code blocks) are permitted in specific document sections to ensure consistent formatting.

How do I fix a filename slug mismatch error?

The skill will use 'git mv' to rename the file so that the filename matches the slugified title found in the document's frontmatter.

Synapse Documentation Specialist

Name: Synapse Documentation Specialist
Author: millstonehq

bymillstonehq

0•

Content Management

Manages and validates structured Synapse knowledge bases using strict schema and body-grammar rules for 15 document types.

The Synapse Documentation Specialist skill enables Claude to manage highly structured knowledge management systems with precision. It streamlines the creation, validation, and repair of documentation across 15 standard formats including ADRs, PRDs, and TDDs. By enforcing strict YAML frontmatter schemas and body-grammar rules, it ensures that your documentation vault remains consistent, searchable, and professional. Whether you are scaffolding a new technical design or fixing validation errors in complex meeting notes, this skill automates the tedious aspects of documentation compliance.

Key Features

01Intelligent content restructuring to meet section-specific node requirements

02Automatic filename and slug alignment for consistent vault architecture

03Support for local schema overrides and custom documentation standards

04Strict validation of YAML frontmatter and markdown body-grammar rules

050 GitHub stars

06Automated scaffolding for 15 document types with sequential ID generation

Use Cases

01Auditing and bulk-fixing validation errors in large documentation vaults

02Scaffolding and maintaining Technical Design Documents (TDDs) and ADRs

03Enforcing organizational writing standards across product and engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add millstonehq/synapse synapse-docs

For use in Claude.ai and ChatGPT