---
description: Assess documentation quality
allowed-tools: mcp__plugin_doc-manager_doc-manager__docmgr_assess_quality, mcp__plugin_doc-manager_doc-manager__docmgr_validate_docs
---

# Documentation Quality Assessment

Run comprehensive quality assessment against 7 criteria.

doc-expert agent Please run a documentation quality assessment.

Execute the quality assessment workflow:

1. **Run Assessment**: Execute `docmgr_assess_quality` to evaluate documentation against 7 criteria:
   - Relevance
   - Accuracy
   - Purposefulness
   - Uniqueness
   - Consistency
   - Clarity
   - Structure

2. **Also Run Validation**: Execute `docmgr_validate_docs` to check:
   - Broken links
   - Missing assets
   - Code snippet syntax
   - Convention compliance

3. **Present Findings**: Provide a comprehensive report with:
   - Overall quality score
   - Per-criterion scores
   - Specific issues with file paths and line numbers
   - Validation results
   - Actionable recommendations

Format the output:

```
## Documentation Quality Report

### Overall Assessment: {excellent | good | fair | poor}

### Quality Scores

| Criterion | Score | Issues |
|-----------|-------|--------|
| Relevance | {score} | {count} |
| Accuracy | {score} | {count} |
| Purposefulness | {score} | {count} |
| Uniqueness | {score} | {count} |
| Consistency | {score} | {count} |
| Clarity | {score} | {count} |
| Structure | {score} | {count} |

### Validation Results
- **Links**: {count} checked, {count} issues
- **Assets**: {count} checked, {count} issues
- **Code Snippets**: {count} checked, {count} issues

### Specific Issues

**High Priority** (poor scores):
- {file}:{line} - {issue description}

**Medium Priority** (fair scores):
- {file}:{line} - {issue description}

### Recommendations
1. {actionable recommendation}
2. {actionable recommendation}

### Next Steps
- Fix high-priority issues first
- Run /doc-sync after fixes to update baseline
```

If user wants to fix issues:
```
Would you like me to help fix these issues? I can delegate the revisions to doc-writer agent.
```
