dita-skills

Guides correct setup of pydita's DitaContext for a DITA processing pipeline. Use this skill when you need to wire together resolveMap(), KeyspaceManager, DitavalFilter, and DitaContext, or when a pipeline is failing because of incorrect initialisation order, missing DITA-OT configuration, or a mismatched errors dictionary.

Analyzes a DITA topic or map file for quality and maintainability issues beyond basic DTD validity. Use this skill after validate-dita-topic or validate-ditamap when you want to check shortdesc length, topic size, step count, nesting depth, conref chain problems, keyref-vs-href balance, duplicate content, and empty elements. Returns structured JSON with categorized findings.

Assists with DITAVAL conditional processing files for filtering and flagging DITA content at build time. Use this skill to validate an existing DITAVAL file, generate a new DITAVAL template from a list of conditions, or understand action priority and style-conflict resolution rules. Returns structured JSON for validation or XML output for generation.

Reference skill for pydita's error recording and reporting model. Use this skill when you need to understand how errors are accumulated in the shared errors dict, work with ErrorRecord and SEVERITY, filter errors by severity level, or produce a formatted error report using reportErrors(). Covers DitaContext.recordError() and Logger/ConsoleLogger helpers.

Generates a valid DITA 1.3 bookmap template. Use this skill when you need a correctly structured starting point for a DITA bookmap with booktitle, bookmeta, frontmatter, chapter placeholders, appendix, and backmatter scaffolding. Output includes the correct DOCTYPE declaration.

Generates a valid DITA 1.3 XML topic template for a given topic type. Use this skill when you need a correctly structured starting point for concept, task, reference, troubleshooting, glossentry, or base topic authoring. Output includes the correct DOCTYPE declaration, required elements, and commonly used optional elements pre-scaffolded.

Generates a valid DITA 1.3 map template. Use this skill when you need a correctly structured starting point for a DITA map with topicref placeholders, key definitions, and an optional relationship table. Output includes the correct DOCTYPE declaration.

Scans one or more DITA 1.3 topics and automatically generates keydef entries and keyref suggestions. Use this skill when you want to enforce reuse-first authoring, detect repeated inline text or repeated hrefs that should be centralised in the map, or migrate a set of topics to use keyrefs instead of hard-coded values. Returns ready-to-paste keydef XML plus a change list showing exactly which elements to update.

Guides debugging of pydita key space construction and key resolution failures. Use this skill when keys are not resolving, keyscoped references return None, duplicate key warnings appear, or you need to inspect the key space tree structure built by KeyspaceManager from a resolved DITA map.

Reference skill for pydita's resolvemap module. Use this skill when you need to flatten a DITA map tree into a single in-memory document using resolveMap(), understand how submaps are inlined as topicgroup elements, apply DITAVAL filtering during resolution, or discover all files referenced by a map with getDirectFilesFromMap().

Converts a PDF document into a complete DITA 1.3 guide by running a 5-stage automated pipeline: PDF text extraction, topic chunking, validation, best-practices optimization, and full-guide review. Use this skill when you need to migrate legacy PDF documentation into structured DITA XML, bootstrap a DITA project from an existing PDF manual, or verify the quality of the generated DITA output. Integrates with validate-dita-topic, validate-ditamap, dita-best-practices, and review-dita-guide.

Improves the structure and modularity of existing DITA content. Use this skill when you need to split an oversized topic into focused sub-topics, convert duplicate paragraphs into conref fragments, replace inline href links with keyref references, or upgrade a generic topic element to a more specific type (concept, task, or reference).

Reviews an entire DITA publication from a root bookmap or ditamap. Traverses the full hierarchy — root map → child ditamaps → leaf topics — and produces a consolidated validation report covering structure, DTD compliance, best practices, and cross-guide issues (missing files, circular map references, duplicate topic IDs) that single-file validators cannot detect.

Validates a DITA 1.3 bookmap file against structural rules derived from the DITA 1.3 bookmap DTD. Use this skill when you need to check bookmap element order (title, bookmeta, frontmatter, chapter, part, appendix, backmatter), booktitle completeness, appendices vs appendix mixing, and chapter presence. Returns structured JSON with errors and warnings.

Validates a DITA 1.3 topic file against structural and semantic rules derived from the official DITA 1.3 DTDs. Use this skill when you need to check a concept, task, reference, troubleshooting, glossentry, or base topic for missing required elements, incorrect nesting, duplicate IDs, malformed conref/keyref, or shortdesc quality issues. Returns structured JSON with errors and warnings.

Validates a DITA 1.3 map file against structural rules derived from the DITA 1.3 map DTD. Use this skill when you need to check topicref completeness (href or keyref required), key uniqueness, collection-type values, reltable structure, nesting depth, or broken reference patterns. Returns structured JSON with errors and warnings.

Guides implementation of custom Visitor and Visitable classes in pydita. Use this skill when you need to write a new tree walker for KeySpace or KeyDefinition nodes, implement a custom report generator, or understand how the existing visitors (PullUpVisitor, PushDownVisitor, KeyspaceReportingVisitor, DitavalVisitor) work so you can extend or replace them.

Provides XSLT and XPath assistance for DITA 1.3 transformations, including DITA-OT plugin development. Use this skill when you need XPath expressions for DITA element selection, XSLT template match patterns using DITA class attributes, transformation override guidance for DITA-OT, or help with specialization class attribute values.