name: epub-quality description: "Quality review skill based on EPUB 3.3 (W3C Recommendation). Performs structure validation, specification compliance checking, and accessibility evaluation of EPUB files, generating reports with specification rationale. Use this skill for any EPUB-related verification tasks including validation, quality checks, spec compliance confirmation, and e-book inspection."

EPUB Quality Review Skill

日本語版 / Japanese

A skill for performing quality reviews of EPUB files based on the EPUB 3.3 specification. Combines pre-parsed normative requirements (MUST/SHOULD/MAY) from the W3C EPUB 3.3 Recommendation with automated validation scripts to generate validation reports with specification rationale.

Specification Sources

Requirements Data

This skill includes the following pre-parsed requirements data:

Requirement ID formats:

• EPUB33-R0001 through EPUB33-R0135: EPUB 3.3 core
• EPUBA11Y-R0001 through EPUBA11Y-R0031: Accessibility

Tools

Automated Validation Script

# Run basic structure validation
bash scripts/validate-epub.sh <epub-file>

# Run with specified output directory
bash scripts/validate-epub.sh <epub-file> /path/to/output

The script checks:

• ZIP structure (mimetype, compression method)
• container.xml integrity
• Package Document required metadata
• Navigation Document structure
• Content Document XML syntax
• CSS prohibited properties
• Filename and path restrictions
• Security (file: URLs, external entities)

Specification Reference Tools

• w3c-mcp: Use search_w3c_specs, get_w3c_spec to retrieve specification metadata
• web_fetch: Use when the specification text needs to be consulted
• Pre-parsed data: Reference JSON files via Read

Verification Workflow

1. Receive EPUB file
   └─ Run automated validation via scripts/validate-epub.sh

2. Review automated validation results
   ├─ Tally PASS / FAIL / WARN counts
   └─ Check for critical violations

3. Detailed analysis against requirements JSON
   ├─ Identify applicable requirements from epub33-requirements.json
   ├─ Indicate requirement ID, section, and normative level
   └─ List items requiring manual review

4. Accessibility evaluation
   ├─ Cross-reference with epub-a11y-requirements.json
   ├─ Check Schema.org metadata presence
   └─ Verify WCAG compliance level

5. Generate report
   └─ Output validation report in Markdown format

Verification Categories

Report Format

Report validation results in the following format:

## EPUB 3.3 Quality Review: [filename]

### Summary
- Inspection date: YYYY-MM-DD
- MUST violations: X items
- SHOULD non-compliance: X items
- Passed items: X items

### Validation Results

#### ❌ MUST Violations
| ID | Section | Requirement | Finding |
|:---|:---|:---|:---|
| EPUB33-R0057 | §5.4.3.1 | dc:title MUST exist | dc:title is empty |

#### ⚠️ SHOULD Non-compliance
| ID | Section | Requirement | Finding |
|:---|:---|:---|:---|

#### ✅ Passed
| Category | Items Checked | Result |
|:---|:---|:---|

#### ℹ️ Accessibility
| ID | Requirement | Status |
|:---|:---|:---|

Relationship to EPUBCheck

EPUBCheck is the official EPUB validation tool. This skill does not replace EPUBCheck, but complements it as follows:

• EPUBCheck: Exhaustive mechanical verification (automatic checking of all requirements)
• This skill: Explanations with specification rationale, improvement suggestions, and accessibility-focused advice

In environments where EPUBCheck is available, running EPUBCheck first and then using this skill's specification data to explain the results is the most effective approach.

# Install and run EPUBCheck (Java required)
java -jar epubcheck.jar target.epub
# JSON output
java -jar epubcheck.jar target.epub --json result.json

Additional References

Consult the following for detailed specification references:

Updating

When the specification is updated (e.g., EPUB 3.4):

1. Retrieve the new specification URL via w3c-mcp
2. Fetch the specification text via web_fetch
3. Re-extract MUST/SHOULD/MAY requirements
4. Update requirements.json
5. Update scripts/validate-epub.sh
6. Update version information in SKILL.md