About

Imported from vladm3105/aidoc-flow-framework (platforms/claude-code-plugin/skills/quality-advisor/SKILL.md). Install upstream with npx skills add vladm3105/aidoc-flow-framework --skill quality-advisor. Copyright stays with the author.

quality-advisor

Name: quality-advisor
Author: vladm3105

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 documentation.

Behavior

Given the artifact content, its type, and an optional check level (quick / standard / strict), the skill:

Loads template requirements for the artifact's layer from ${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml — required sections, minimum tag count, and special rules (e.g. PRD KPIs must be quantitative, EARS WHEN-THE-SHALL syntax, SPEC YAML form). Code is the downstream execution target of IPLAN, not a documentation artifact.
Scores section completion — detects required sections, flags missing/partial ones, and reports a completion score with specific issues.
Detects anti-patterns — missing Document Control, placeholder text, vague acceptance criteria, missing traceability tags, broken links, ID-format violations, empty sections, orphan artifacts, count/cross-reference mismatches, undefined acronyms, mixed ID notation, forward references to non-existent documents — each with severity and a fix suggestion.
Validates cumulative tagging — confirms the artifact carries exactly the upstream tag families its layer requires (BRD 0 → … → IPLAN 7), with no gaps and no downstream tags.
Checks naming — document IDs TYPE-NN, element IDs TYPE.NN.SS.xxxx, threshold tags, and filename slugs, deferring to ../doc-naming/SKILL.md and ${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md; flags legacy patterns.
Generates a quality report — overall status and score, error/warning/info counts, per-area results, and prioritized recommendations plus next steps (typically: fix errors, then run ../doc-validator/SKILL.md).

The framework ships no runtime code — this skill IS the checker, applying the declarative checks above against the spec.

Related Resources

Layer registry & tag rules: ${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml
ID & tag standards: ${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md
Layer READMEs: ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/README.md · ${CLAUDE_PLUGIN_ROOT}/framework/layers/05_ADR/README.md
Naming: ../doc-naming/SKILL.md
Post-creation validation: ../doc-validator/SKILL.md · layer -audit skills (e.g. ../doc-prd-audit/SKILL.md)
Routing & next steps: ../doc-flow/SKILL.md

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/vladm3105-aidoc-flow-framework-quality-advisor/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

vladm3105-aidoc-flow-framework-quality-advisor.ocm.jsonjson

{
  "ocm": "1",
  "id": "vladm3105-aidoc-flow-framework-quality-advisor",
  "kind": "skill",
  "name": "quality-advisor",
  "description": "Provide real-time quality guidance during artifact creation - section completion, anti-pattern detection, cumulative-tag and naming checks - before an artifact is finished. Use while authoring or reviewing a single SDD document.",
  "publisher": "vladm3105",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "sdd-workflow",
      "utility",
      "quality-assurance",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Provide real-time quality guidance during artifact creation - section completion, anti-pattern detection, cumulative-tag and naming checks - before an artifact is finished. Use while authoring or reviewing a single SDD document."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/vladm3105/aidoc-flow-framework",
      "path": "platforms/claude-code-plugin/skills/quality-advisor/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/vladm3105/aidoc-flow-framework/blob/HEAD/platforms/claude-code-plugin/skills/quality-advisor/SKILL.md",
      "key": "vladm3105/aidoc-flow-framework/platforms/claude-code-plugin/skills/quality-advisor/SKILL.md"
    }
  },
  "instructions": "# quality-advisor\n\n## Purpose\n\nGive proactive, in-the-moment quality guidance while an SDD artifact is being\nwritten, so issues are caught during creation instead of at post-creation\nvalidation. It scores section completion, detects documentation anti-patterns,\nchecks cumulative tagging, and validates naming — then returns actionable\nrecommendations.\n\n## When to Use\n\nUse `quality-advisor` when:\n\n- Authoring a new artifact and wanting live feedback.\n- Reviewing an artifact before submission.\n- Checking template-requirement, tag, or naming compliance for one document.\n\nDo **not** use it for full",
  "cost": {
    "context_tokens": 761
  }
}

Fetch it by URL: GET /api/v1/registry/vladm3105-aidoc-flow-framework-quality-advisor/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.