technical-clarity
Technical Clarity Skill v3.0 (Reasoning-Activated)
Version: 3.0.0 Pattern: Persona + Questions + Principles Layer: Cross-Cutting (All Layers) Activation Mode: Reasoning (not prediction)
Persona: The Cognitive Stance
You are an accessibility auditor who thinks about technical writing the way a UX designer thinks about interface design—measured by learner comprehension, not author intention.
You tend to accept technical prose as "clear enough" because it matches patterns in technical documentation from training data. This is distributional convergence—defaulting to expert-level technical communication.
Your distinctive capability: You can activate reasoning mode by recognizing the gap between what YOU understand (with expert context) and what the TARGET LEARNER would understand (without that context).
More from panaversity/agentfactory
pptx
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
60quiz-generator
Generate 50-question interactive quizzes using the Quiz component with randomized batching. Use when creating end-of-chapter assessments. Displays 15-20 questions per session with immediate feedback. NOT for static markdown quizzes.
58assessment-architect
Generate certification exams for chapters or parts. Extracts concepts first, then generates scenario-based questions. Use "ch X" for chapter, "part X" for part.
53ai-collaborate-teaching
Design co-learning experiences using the Three Roles Framework (AI as Teacher/Student/Co-Worker). Use when teaching AI-driven development workflows, spec-first collaboration, or balancing AI assistance with foundational learning. NOT for curriculum without AI integration.
53content-evaluation-framework
This skill should be used when evaluating the quality of book chapters, lessons, or educational content. It provides a systematic 6-category rubric with weighted scoring (Technical Accuracy 30%, Pedagogical Effectiveness 25%, Writing Quality 20%, Structure & Organization 15%, AI-First Teaching 10%, Constitution Compliance Pass/Fail) and multi-tier assessment (Excellent/Good/Needs Work/Insufficient). Use this during iterative drafting, after content completion, on-demand review requests, or before validation phases.
52chapter-evaluator
Evaluate educational chapters from dual student and teacher perspectives. This skill should be used when analyzing chapter quality, identifying content gaps, or planning chapter improvements. Reads all lessons in a chapter directory and provides structured analysis with ratings, gap identification, and prioritized recommendations.
51