mindmap-html-generator

Generate offline interactive mindmap HTML and convert Markdown, outlines, meeting notes, chapter structures, or JSON trees into markmap-compatible format. Use when organizing long text into mindmaps, converting meeting notes to mindmap pages, generating final HTML via markmap-cli, or adding browsable mindmaps to deliverables.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

73%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-sequenced, actionable skill body with explicit validation and feedback loops for a batch HTML-generation task. Its main weakness is conciseness: a large block of generic governance boilerplate and some detail-heavy inline rules that could be offloaded to the reference file.

Suggestions

Remove or collapse the templated governance sections (When to Use, When Not to Use, Required Inputs, Output Contract, Failure Handling, User Checkpoints, Input Validation, Quick Validation) into a few concise lines, since most of this is general practice Claude already follows.

Move the detailed 'Content Richness Requirements', 'Information Extraction Priority', and 'Paper Input Enhancement Rules' into references/input-patterns.md, keeping only the top-level principles in SKILL.md to reduce inline bulk.

Add one complete worked example invocation (a real input file path, the resulting CONFIG values, and the expected output) so the run path is fully copy-paste ready.

Dimension	Reasoning	Score
Conciseness	The core workflow sections are reasonably tight, but roughly 80 lines of templated governance boilerplate (When to Use, When Not to Use, Required Inputs table, Output Contract, Failure Handling, User Checkpoints, Input Validation, Quick Validation) state general practices Claude already knows and could be trimmed, matching the score-3 anchor of mostly-efficient with some unnecessary explanation.	3 / 5
Actionability	Provides a concrete runnable command ("python scripts/generate_mindmap_html.py") and specific named CONFIG keys (input_path, auto_bold_levels, plain_text_root_max_children, etc.), but lacks a complete worked example invocation with a real input, leaving minor gaps consistent with the score-4 anchor.	4 / 5
Workflow Clarity	A clear numbered 1-5 sequence ends in an explicit "Validate Results" step with self-checks and feedback loops ("If nodes are too long, go back to compress input text, then re-run"), matching the score-5 anchor including error-recovery loops for this batch generation task.	5 / 5
Progressive Disclosure	A "Resources" section clearly signals one-level-deep references to scripts/generate_mindmap_html.py and references/input-patterns.md that are real bundle files, but some detailed inline guidance (Content Richness, Paper Input Enhancement Rules) could live in a reference and slightly bloats the overview, fitting the score-4 anchor of good structure with minor gaps.	4 / 5
	Total	16 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that explicitly states both capabilities and use-when triggers with concrete, natural language. Minor gap is the absence of file-extension triggers and a few common synonyms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ("Generate offline interactive mindmap HTML", "convert Markdown, outlines, meeting notes, chapter structures, or JSON trees into markmap-compatible format") with comprehensive coverage across input types, matching the score-5 anchor.	5 / 5
Completeness	Explicitly answers both "what" (generate offline mindmap HTML, convert multiple formats to markmap-compatible format) and "when" ("Use when organizing long text into mindmaps, converting meeting notes to mindmap pages, ... adding browsable mindmaps to deliverables") with concrete trigger phrases, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Good keyword coverage including natural terms (mindmaps, meeting notes, JSON trees, deliverables, markmap-cli) but missing common synonyms ("mind map", "concept map") and file extensions (.md/.html/.json), so it falls just short of comprehensive.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (offline markmap-based mindmap HTML generation) with distinct, specific triggers unlikely to fire for unrelated skills, matching the score-5 anchor for minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Other/mindmap-html-generator/SKILL.md
Commit: f5ef65b

Reviewed: ~19 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.