aiskillstore/marketplace / skills/abdulsamad94/chapter-analyzer
chapter-analyzer
VerifiedValidates and analyzes Docusaurus MDX chapters for structure, pedagogical quality, and component usage.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.3 KB |
| skill-report.json | config | 16.7 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-18T09:41:13.486Z",
"slug": "abdulsamad94-chapter-analyzer",
"source_url": "https://github.com/AbdulSamad94/Hackhaton-SpecsKitPlus/tree/master/.claude/skills/chapter-analyzer",
"source_ref": "master",
"model": "claude",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "a446e9a0c0947e4d4df4bd50a52a8a626fdf4e18e623feb7f67c617e96d5c320",
"tree_hash": "bac3d1521be5cdbb567e902f97bcc6ed2e8a97ba16fb0d0e9407dc1d6a864f9c",
"provenance": {
"model_effective": "claude",
"fallback_chain": [
{
"agent": "codex",
"outcome": "failed",
"error": "2026-07-18T09:41:13.618202Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-18T09:41:13.639960Z ERROR codex_models_manage…"
},
{
"agent": "claude",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "Chapter Analyzer",
"description": "Analyze Docusaurus MDX chapters for required frontmatter, structure, learning flow, and supported interactive components.",
"summary": "Review Docusaurus MDX chapters against clear structural and teaching guidelines.",
"icon": "📦",
"author": "AbdulSamad94",
"license": "MIT",
"tags": [
"docusaurus",
"mdx",
"documentation",
"content-quality",
"chapter-review"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
],
"category": "documentation"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All twelve static findings are false positives. Markdown backticks document chapter syntax and component examples, while the alleged reconnaissance entries are documentation guidance. No command execution, system inspection, prompt injection, or data-exfiltration intent was found in SKILL.md.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 9,
"line_end": 9
},
{
"file": "SKILL.md",
"line_start": 10,
"line_end": 10
},
{
"file": "SKILL.md",
"line_start": 14,
"line_end": 21
},
{
"file": "SKILL.md",
"line_start": 21,
"line_end": 26
},
{
"file": "SKILL.md",
"line_start": 26,
"line_end": 27
},
{
"file": "SKILL.md",
"line_start": 27,
"line_end": 37
},
{
"file": "SKILL.md",
"line_start": 37,
"line_end": 38
},
{
"file": "SKILL.md",
"line_start": 38,
"line_end": 39
},
{
"file": "SKILL.md",
"line_start": 39,
"line_end": 39
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:9:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 9,
"line_end": 9,
"snippet": "- **Location**: `textbook/docs/`"
},
{
"id": "external_commands:SKILL.md:10:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 10,
"line_end": 10,
"snippet": "- **Format**: MDX (`.mdx` or `.md`)"
},
{
"id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 14,
"line_end": 21,
"snippet": "```yaml"
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 21,
"line_end": 26,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 26,
"line_end": 27,
"snippet": "- Start content with H2 (`##`)."
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 27,
"line_end": 37,
"snippet": "- Do not use H1 (`#`) within the body."
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 37,
"line_end": 38,
"snippet": "- `<Quiz questions={[...]} />`: For knowledge checks."
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 38,
"line_end": 39,
"snippet": "- `<Simulation type=\"ros2-node\" ... />`: For embedded simulations."
},
{
"id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 39,
"line_end": 39,
"snippet": "- `<Tabs>` / `<TabItem>`: For multi-language code blocks (Python/C++)."
},
{
"id": "blocker:SKILL.md:13:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 13,
"line_end": 13,
"snippet": "Every chapter must have valid YAML frontmatter:"
},
{
"id": "blocker:SKILL.md:16:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 16,
"line_end": 17,
"snippet": "id: my-chapter-id"
},
{
"id": "blocker:SKILL.md:44:system-reconnaissance",
"category": "blocker",
"severity": "low",
"pattern": "System reconnaissance",
"file": "SKILL.md",
"line_start": 44,
"line_end": 44,
"snippet": "- **Clarity**: Avoid jargon without explanation."
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:9:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:10:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "external_commands:SKILL.md:39:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.99,
"reason": "The detected backticks are Markdown code delimiters used to document paths, headings, and MDX components; no shell command is present."
},
{
"id": "blocker:SKILL.md:13:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line documents YAML frontmatter or writing guidance and does not inspect the system, execute commands, or collect system information."
},
{
"id": "blocker:SKILL.md:16:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line documents YAML frontmatter or writing guidance and does not inspect the system, execute commands, or collect system information."
},
{
"id": "blocker:SKILL.md:44:system-reconnaissance",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "This line documents YAML frontmatter or writing guidance and does not inspect the system, execute commands, or collect system information."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 1,
"total_lines": 45,
"audit_model": "claude",
"audited_at": "2026-07-18T09:41:13.486Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Review Docusaurus MDX Chapters",
"value_statement": "Documentation teams need consistent chapters that are easy to navigate and teach from. This skill checks MDX chapter structure, learning flow, and approved interactive components.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"Docusaurus",
"MDX chapter review",
"documentation quality",
"YAML frontmatter",
"technical writing",
"learning content"
],
"actual_capabilities": [
"Checks for YAML frontmatter fields used by Docusaurus chapters.",
"Reviews heading hierarchy and flags body-level H1 usage.",
"Evaluates whether a chapter includes an introduction, objectives, core content, interaction, and summary.",
"Checks for documented Quiz, Simulation, Tabs, and TabItem component usage.",
"Reviews tone for accessible, encouraging technical instruction."
],
"limitations": [
"It evaluates chapters against the rules documented in the skill only.",
"It does not build a Docusaurus site or validate component implementations.",
"It cannot confirm factual accuracy without source material.",
"It does not replace editorial review for audience needs or curriculum goals."
],
"use_cases": [
{
"title": "Review a new lesson",
"description": "Check a draft MDX lesson before it is added to a Docusaurus textbook.",
"target_user": "Technical writer"
},
{
"title": "Standardize course chapters",
"description": "Apply the same structure and learning-flow review across a documentation course.",
"target_user": "Documentation lead"
},
{
"title": "Improve contributor drafts",
"description": "Give contributors a clear checklist for frontmatter, headings, and interactive learning elements.",
"target_user": "Open-source maintainer"
}
],
"prompt_templates": [
{
"title": "Check one chapter",
"scenario": "Beginner review",
"prompt": "Review this Docusaurus MDX chapter using the Chapter Analyzer rules. List missing frontmatter, heading, and learning-flow requirements."
},
{
"title": "Validate frontmatter",
"scenario": "Metadata review",
"prompt": "Check this chapter frontmatter for the required id, title, sidebar_label, and description fields. Explain any missing or unclear values."
},
{
"title": "Improve learning flow",
"scenario": "Content revision",
"prompt": "Analyze this MDX chapter for introduction, learning objectives, core content, interactive elements, and summary. Recommend specific improvements."
},
{
"title": "Audit a chapter set",
"scenario": "Advanced documentation review",
"prompt": "Review these Docusaurus MDX chapters against the Chapter Analyzer rules. Produce a prioritized per-file report for structure, pedagogy, component usage, and tone."
}
],
"output_examples": [
{
"input": "Review a chapter that starts with an H1 heading and has no summary.",
"output": [
"Remove the body-level H1 because the Docusaurus title provides it.",
"Add a final summary that recaps the chapter points.",
"Keep the first content heading at H2."
]
},
{
"input": "Check a chapter with valid frontmatter and a Quiz component.",
"output": [
"Frontmatter includes the required chapter fields.",
"The Quiz component supports an interactive knowledge check.",
"Review the chapter for objectives and a closing summary."
]
}
],
"best_practices": [
"Provide the complete MDX chapter, including frontmatter, for an accurate review.",
"Use findings as an editorial checklist and verify recommendations in the rendered site.",
"Apply the same rules consistently across related chapters."
],
"anti_patterns": [
"Do not treat the review as a substitute for building the Docusaurus site.",
"Do not assume component examples prove that components are installed or functional.",
"Do not omit the target audience when requesting tone or pedagogy feedback."
],
"faq": [
{
"question": "What files does this skill review?",
"answer": "It is designed for Docusaurus chapter files written as MDX or Markdown."
},
{
"question": "Does it require a running Docusaurus site?",
"answer": "No. It reviews chapter content and documented conventions."
},
{
"question": "Which frontmatter fields are checked?",
"answer": "The documented rules require id, title, sidebar_label, and description."
},
{
"question": "Can it check heading structure?",
"answer": "Yes. It checks that content starts with H2 and avoids body-level H1 headings."
},
{
"question": "Does it validate custom components?",
"answer": "It checks their documented usage in content, not their runtime implementation."
},
{
"question": "Can it review multiple chapters?",
"answer": "Yes. Provide several chapters and request a per-file, prioritized review."
}
]
},
"file_structure": [
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 45
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |