{"id":"agents365-ai-mermaid-skill","name":"mermaid-skill","homepage":null,"repo_url":"https://github.com/Agents365-ai/mermaid-skill","category":"devtools","subcategories":[],"tags":["ai-ml","devtools","documentation","diagramming","mermaid","claude-code","mmdc","kroki","export","skill"],"what_it_does":"A Claude Code skill that generates Mermaid (.mmd) diagrams from user requests, validates Mermaid syntax before export, and exports to PNG/SVG/PDF using either local mermaid-cli (mmdc) or a fallback Kroki API endpoint.","use_cases":["Generate architecture, sequence, flow, and state diagrams from textual descriptions","Create database ER diagrams and class/OOP diagrams from domain modeling notes","Produce documentation-ready diagram exports (PNG for visuals, SVG/PDF for docs)","Automate a generate→validate→export workflow to reduce broken diagrams"],"not_for":["High-assurance or compliance-critical diagram generation without validation guarantees from the toolchain","Environments that cannot reach external services (Kroki) when mmdc is unavailable","Use as a general-purpose diagramming API/SDK for arbitrary programmatic diagram rendering"],"best_when":"You want end-to-end Mermaid diagram generation with automatic layout and multiple export formats, especially when you benefit from pre-export validation and a Kroki fallback.","avoid_when":"You require strong, explicit API-level security controls, or you must avoid any external network calls (even optional fallbacks).","alternatives":["Manual Mermaid authoring + local mermaid-cli","Kroki CLI/API directly","Other Mermaid editor/automation skills/extensions in Claude Code","Custom scripts that call mermaid-cli or Kroki endpoints"],"af_score":44.8,"security_score":36.2,"reliability_score":26.2,"package_type":"skill","discovery_source":["openclaw"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:35:43.877047+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No authentication described for the skill itself. If Kroki is used, any required credentials (if applicable) are not specified in the provided README; usage examples only show curl without auth."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"README does not discuss pricing tiers for the skill or for any third-party dependency (e.g., Kroki)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":44.8,"security_score":36.2,"reliability_score":26.2,"mcp_server_quality":0.0,"documentation_accuracy":65.0,"error_message_quality":null,"error_message_notes":"The README describes a validation-first workflow (validate before export) and a Fix→revalidate loop, but it does not provide concrete error codes/messages or a specification of failure modes.","auth_complexity":100.0,"rate_limit_clarity":0.0,"tls_enforcement":70.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":35.0,"secret_handling":60.0,"security_notes":"Likely communicates over HTTPS when using web services, but TLS enforcement is not explicitly stated. No auth model or scope control is described for the skill. Dependency hygiene cannot be assessed from the provided content (no dependency list/CVE info). Secret handling practices are not documented; however, the workflow implies local file generation and optional external rendering.","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":10.0,"error_recovery":60.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["If mmdc is unavailable, the skill falls back to Kroki API; external network access and availability may affect outcomes.","Mermaid syntax validation is mentioned, but exact validation behavior and limits (e.g., size/timeout) are not specified.","The skill behavior may differ for Chinese-trigger phrases vs explicit diagram requests; prompting should be explicit when needed."]}}