Instructional Document Generation

Generates structured instructional documents in YAML from briefs with procedures, checkpoints, and compliance validation.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill instructional-document-generation-gozonerd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Instructional Document Generation
Source: https://github.com/gozonerd/shadow-ai-assessment/tree/main/.claude/skills/dmis/task_type/TT-01_Instructional_Document_Generation
Command: npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill instructional-document-generation-gozonerd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Producing consistent, verifiable instructional and training documents from short briefs is slow and error-prone, especially when every factual claim must be traceable and comply with strict accuracy rules. This Skill turns a concise brief into a fully structured instructional document with enforced schema and compliance checks. ## Core Features & Use Cases - Brief-to-Document Generation: Parses a requirements brief and produces a structured YAML instructional document with overview, prerequisites, step-by-step procedures, quality checkpoints, troubleshooting, and appendices. - Schema Validation: Ships a Python validator (scripts/validate_output.py) that checks required fields, procedure structure, quality checkpoints, and accuracy compliance statements. - Accuracy & Anti-Fabrication Enforcement: Embeds 9 accuracy rules (ACC-001 to ACC-009) and 6 anti-fabrication rules (AFR-001 to AFR-006) so every factual claim is traceable and regulatory citations are precise. - Use Case: A training team needs a CommCare data entry procedure document; provide the brief and audience profile, and receive a validated YAML document with numbered steps, verification checkpoints, and troubleshooting guidance. ## Quick Start Generate a TT-01 instructional document from my brief on training field staff for mobile data entry, then validate the output with the included script.

Frequently Asked Questions about Instructional Document Generation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a structured instructional document from a brief?

Provide a brief specifying instructional scope, target audience, and content objectives. The Skill parses the brief, structures content into overview, prerequisites, numbered procedures, quality checkpoints, and troubleshooting, then outputs schema-conformant YAML.

How do I validate TT-01 instructional document output?

Run scripts/validate_output.py with the YAML file path as argument. The script checks required fields, procedure structure, quality checkpoints, and that all nine accuracy rules (ACC-001 through ACC-009) are referenced in the compliance statement.

What output format does instructional document generation produce?

Output is YAML conforming to the TT-01 schema with required fields: title, task_type, version, overview, prerequisites, and procedures. Each procedure needs a step_number and action, and the document must include quality_checkpoints and an accuracy_compliance statement.

Why does TT-01 output validation fail on accuracy compliance?

Validation fails when the accuracy_compliance section does not reference all nine rules ACC-001 through ACC-009. Add a compliance entry mentioning each rule explicitly, and ensure factual claims have traceable sources per the anti-fabrication rules.

What are the limitations of template-based instructional generation?

The Skill requires a well-formed brief with clear objectives and audience definition; vague briefs produce scope drift or assumption creep. It also depends on source materials for factual claims, since unverified statements must be flagged as needing verification.