Agent skill · writing content · aiskillstore
book-scaffolding
Plan, structure, and scaffold large educational books using cognitive load management, just-in-time specification, and pedagogical best practices. Use this skill when planning multi-part, multi-chapter educational works that require narrative continuity, progressive complexity, and hands-on exercises. This skill helps create cohesive learning journeys that balance foundational scaffolding with advanced independence. Activate when tasks involve structuring books, managing cognitive load across chapters, defining part-level narratives, or coordinating multi-phase content development workflows.
Why this skill is useful
Provides structured methodologies for planning educational content that the AI wouldn't reliably generate on its own.
What it needs
About 11k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Skill: Book Scaffolding and Structure Planning Purpose: Plan, structure, and scaffold large educational books using cognitive load management, just-in-time specification, and pedagogical best practices. Constitution Alignment: v4.0.1 emphasizing: Principle 1: Specification Primacy ("Specs Are the New Syntax") Section IIa: Panaversity 4-Layer Teaching Method (progressive lesson structure) Section IIb: AI Three Roles Framework (bidirectional co-learning partnership) Nine Pillars (Section I): AI CLI, Markdown, MCP, AI-First IDEs, Cross-Platform, TDD, SDD, Composable Skills, Cloud-Native Principle 4: Coherent Pedagogical Structure (flexible lesson counts based on concept density) Status: Reusable skill (learned from 002-book-structure sprint, enhanced with structural patterns) Application: Any multi-part, multi-chapter educational work --- Core Principles (9 Learnings from Sprint) 1. Just-In-Time Specification ("Specs Are the New Syntax") ❌ DON'T: Decide everything upfront. Block on all clarifications before moving forward. ✅ DO: Spec what's needed now. Defer part-specific clarifications to when that part is ready for planning. Why: Unblocks work immediately. Clarifications arrive exactly when needed (during chapter-planner phase). Respects SDD loop: Spec → Plan → Implement per part (one at a time). KEY: Specification writing is the PRIMARY skill. Book structure scaffolds specification-first learning across all parts. Example: Part 1 spec created with only Part 1 narrative ("Coder to Super Orchestrator") Agent frameworks for Part 6 deferred until Part 6 is ready for planning Each part planning phase triggers clarifications for that part 2. Minimal MVP Approach ❌ DON'T: Create comprehensive guides, templates, all part specs upfront, skill integration guides, validation guides ✅ DO: Create only essentials. Focus on: Part intros, Chapter placeholders, Part 1 spec, validation report Why: Reduces redundancy. Eliminates over-engineering. Gets to writing faster. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/book-scaffolding