quality-advisor
Quality-advisor gives live feedback while you create or review SDD documents, catching completion gaps, documentation anti-patterns, tag compliance, and naming issues before submission. It scores sections, detects common problems like missing traceability or broken links, validates cumulative tagging across layers, and returns actionable recommendations to fix issues.
Quality-advisor provides real-time quality feedback during SDD artifact authoring to catch issues before completion.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-27
Quality-advisor provides real-time quality feedback during SDD artifact authoring to catch issues before completion. Quality-advisor gives live feedback while you create or review SDD documents, catching completion gaps, documentation anti-patterns, tag compliance, and naming issues before submission. It scores sections, detects common problems like missing traceability or broken links, validates cumulative tagging across layers, and returns actionable recommendations to fix issues.
Use it when
- Yes.
- Quality-advisor validates section completion and template compliance by checking that all required sections are present and properly filled.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
vladm3105/aidoc-flow-framework/quality-advisor · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does quality-advisor do for SDD document quality?
Quality-advisor gives live feedback while you create or review SDD documents, catching completion gaps, documentation anti-patterns, tag compliance, and naming issues before submission. It scores sections, detects common problems like missing traceability or broken links, validates cumulative tagging across layers, and returns actionable recommendations to fix issues.
Can quality-advisor detect anti-patterns in my documentation?
Yes. Quality-advisor detects and flags documentation anti-patterns before submission, including placeholder text, vague criteria, missing traceability, and broken links. It identifies these issues in real time as you author, so you can fix them immediately rather than waiting for formal validation.
How does quality-advisor validate SDD section requirements?
Quality-advisor validates section completion and template compliance by checking that all required sections are present and properly filled. It also verifies naming conventions for document IDs, checks document control and traceability tags, and validates cumulative tagging requirements across artifact layers.
What real-time feedback on artifact completion does quality-advisor provide?
Quality-advisor offers in-the-moment SDD feedback as you write, scoring sections and flagging gaps in completion. It identifies missing sections, incomplete fields, and compliance deviations so you can address them during authoring rather than discovering them during formal review.
Does quality-advisor check naming and traceability requirements?
Yes. Quality-advisor validates artifact naming and IDs against conventions, checks document control and traceability tags, and ensures cumulative tagging compliance. It catches naming issues and traceability gaps early, helping you meet all documentation standards before submission.
Can I use quality-advisor to review artifacts before formal validation?
Absolutely. Quality-advisor is designed for pre-submission review, catching documentation issues before formal validation processes. It provides comprehensive quality guidance during authoring and a final review pass to ensure your SDD artifact meets all requirements and standards.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
quality-advisor
Purpose
Give proactive, in-the-moment quality guidance while an SDD artifact is being written, so issues are caught during creation instead of at post-creation validation. It scores section completion, detects documentation anti-patterns, checks cumulative tagging, and validates naming — then returns actionable recommendations.
When to Use
Use quality-advisor when:
- Authoring a new artifact and wanting live feedback.
- Reviewing an artifact before submission.
- Checking template-requirement, tag, or naming compliance for one document.
Do not use it for full bidirectional traceability or whole-project
validation (use ../doc-validator/SKILL.md), or non-SDD
(truncated - see the full file via the links below)
File tree — 1 file
platforms/claude-code-plugin/skills/quality-advisor/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Get real-time quality feedback while authoring SDD artifacts”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
doc-validator enforces consistency rules across your entire SDD documentation corpus—catching broken links, orphaned artifacts, cumulative-tag gaps, duplicate IDs, and traceability gaps across all 8 layers. It runs declarative checks against your corpus structure and can optionally repair safely-fixable issues like missing reciprocal links or stale metadata. Use it before releases or after batch generation to ensure your documentation chain stays machine-verifiable and traceable.
project-adopt brings an established codebase into the Specification-Driven Development workflow by detecting existing code and documentation, inferring the domain, and scaffolding the 8-layer artifact structure. It reverse-engineers baseline artifacts from your running system at draft status, seeding the SDD backbone in one setup pass. Hand off to doc-flow and per-layer audits to close gaps and promote drafts to ready.
doc-prd generates a Product Requirements Document as Layer 2 of the SDD workflow, converting business requirements into product capabilities, user personas, and measurable success criteria. It structures features and acceptance criteria at the container level, sitting between upstream BRD and downstream EARS artifacts.
doc-tdd generates Layer 7 TDD artifacts that translate component contracts into concrete test cases with quality thresholds. It maps BDD scenarios to unit, integration, functional, and end-to-end tests, establishes coverage targets per type, and sequences the Red-Green-Refactor workflow before implementation begins.
gate-check automates the verification step in the change governance process by selecting the correct approval gate based on affected layers, running its entry criteria and error checks, and populating the approval form for human sign-off. It verifies but never approves—all signature and decision fields remain blank for the designated approvers.
doc-adr-fixer consumes audit reports and patches ADRs to resolve structural, referential, and content issues identified during quality review. It supports both team-mode validation (with multi-lens dispatch) and single-pass remediation, backing up originals and reverting regressions to prevent silent failures.
More skills testing-quality-standards (MIT)