Menu
Review check categories and algorithms for technical specification analysis
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create comprehensive architecture decision documents through collaborative 8-step workflow. Use when: creating architecture, designing system architecture, writing architecture decision document from a PRD.
Generate styled draw.io (.drawio) files from architecture shard document content with C4-appropriate shapes, colors, and layout. Use when: generating architecture diagrams, converting architecture to drawio, creating C4 diagrams, generating draw.io files from shard documents.
Shard a monolithic architecture document into 7 focused sub-documents with Mermaid diagrams, gap analysis, and cross-references. Use when: sharding architecture document, decomposing architecture, splitting architecture into sub-documents.
BMAD Architecture methodology, quality standards, and reference data for creating architecture decision documents. Use when: working with architecture documents, checking architecture quality standards, understanding architecture methodology.
Manage Confluence pages at onemount.atlassian.net via the REST API v2. Use this skill whenever the user wants to fetch, view, search, create, edit, or update a Confluence page — including pasting a Confluence URL and asking to edit it, asking about page content, listing pages in a space, or pushing local changes back. Trigger on any mention of Confluence pages, Confluence URLs (onemount.atlassian.net/wiki), page IDs, Confluence spaces, or requests like "update the confluence page", "fetch the PRD from confluence", "push my changes to confluence". Also trigger when the user asks to create a new Confluence page or search for existing pages.
Bidirectional sync between local Markdown files and Confluence pages. Use this skill when the user wants to push a .md file to Confluence, pull a Confluence page as .md, batch-push a directory of markdown files, or check sync status. Trigger on requests like "push this doc to Confluence", "pull the PRD from Confluence as markdown", "sync docs to Confluence", "convert this markdown to a Confluence page", or "batch push all docs".
| name | spec/review |
| description | Review check categories and algorithms for technical specification analysis |
This skill defines the check categories and algorithms used to review technical specifications for quality, consistency, and contamination.
Build a vocabulary from the document itself. Extract defined terms from section headers, bold text, code identifiers, table columns, and glossary entries. Record each term's canonical form, every location where it appears, and surrounding context. This registry is the foundation for all other checks.
Using the term registry, verify that every term is used consistently throughout the document. Detect: same concept with different names, same name with conflicting descriptions, acronym misuse, capitalization drift, and singular/plural inconsistency. See references/consistency-rules.md for the full algorithm.
Find all intra-document references (e.g., "see Section X", "as described in", "defined above/below") and verify that each target exists and the reference remains accurate. Flag broken links, renamed sections, and references to removed content.
Apply configurable regex patterns to detect content that does not belong in a finished specification: planning language, implementation status markers, temporal statements, and environment leakage. See references/contamination-patterns.md for the full pattern library.
Verify the document's organizational integrity: sections have substance (not just headers), no orphaned references exist, the hierarchy is logical, and required sections are present.
All findings are compiled into a structured report. See references/report-template.md for the output format.
references/contamination-patterns.md — Regex patterns for detecting non-spec contentreferences/consistency-rules.md — Algorithmic rules for term consistency checkingreferences/report-template.md — Structured output format for review reports