{"eval":{"version":"openagentskill-skill-eval-v1","slug":"jonschlinkert-markdown-toc","name":"Markdown Toc","generated_at":"2026-07-04T01:56:58.680Z","task_input":"Evaluate Markdown Toc before installing it in an AI agent workflow","status":"failed","score":70,"risk_level":"high","decision":{"recommendation":"do_not_auto_install","reason":"Permission surface: shell or command execution, filesystem or document access","auto_install_allowed":false,"policy":"block","human_review_required":true},"task_fit":{"score":84,"suited_tasks":["Document processing workflows","Claude Code teams","teams that value GitHub adoption signals","Read uploaded files","Extract structured fields","Prepare clean context for downstream agents","Inspect source files","Explain architecture"],"suited_agents":["JavaScript","Markdown","Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"]},"install":{"command":"npx skills add jonschlinkert/markdown-toc","ready":true,"policy":"review","safety_label":"Avoid automatic install","targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx skills add jonschlinkert/markdown-toc"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"Markdown Toc\" agent skill from https://github.com/jonschlinkert/markdown-toc. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"Markdown Toc\" as a Claude Code skill from https://github.com/jonschlinkert/markdown-toc. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"Markdown Toc\" from https://github.com/jonschlinkert/markdown-toc into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects."}]},"trust":{"score":80,"label":"Strong shortlist","version":"trust-score-v4","evidence":{"stars":"1.8K GitHub stars","repoActivity":"1.8K stars, 712 forks","lastPushed":"2y since push","license":"MIT","repository":"https://github.com/jonschlinkert/markdown-toc","install":"npx skills add jonschlinkert/markdown-toc","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"}},"audit":{"score":74,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","Repository appears stale","Repository looks stale","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Recent maintenance: 2y since push","Permission surface: shell or command execution, filesystem or document access"]},"safety_gate":{"score":46,"tier":"experimental","label":"Experimental","auto_install_policy":"review","blocked":false,"permission_hints":[{"id":"shell","label":"Shell or command execution","reason":"Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.","severity":"high"},{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"}],"policy_warnings":["High-risk permission hints: Shell or command execution","Permission surface may require sandboxing"]},"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":84,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate Markdown Toc before installing it in an AI agent workflow","document-processing","Document processing workflows; Claude Code teams; teams that value GitHub adoption signals"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add jonschlinkert/markdown-toc"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add jonschlinkert/markdown-toc"]},{"id":"trust_score","label":"Trust score","status":"warn","score":80,"required_for_auto_install":true,"detail":"Good trust signals with a few areas worth checking before rollout.","evidence":["Strong shortlist","1.8K GitHub stars","MIT"]},{"id":"audit_score","label":"Audit score","status":"warn","score":74,"required_for_auto_install":true,"detail":"Needs review","evidence":["Permission surface may require sandboxing"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"warn","score":46,"required_for_auto_install":true,"detail":"Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","evidence":["Test manually in an isolated workspace and compare against safer alternatives.","High-risk permission hints: Shell or command execution"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"pass","score":100,"required_for_auto_install":false,"detail":"Metadata includes enough usage and workflow context","evidence":["Strong README/SKILL.md context"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"MIT","evidence":["MIT"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"fail","score":38,"required_for_auto_install":false,"detail":"2y since push","evidence":["2y since push"]},{"id":"permission_surface","label":"Permission surface","status":"fail","score":48,"required_for_auto_install":true,"detail":"shell or command execution, filesystem or document access","evidence":["Shell or command execution: high","Network access: medium","Filesystem access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"pass","score":82,"required_for_auto_install":false,"detail":"Alternative skills are available for comparison.","evidence":["microsoft-markitdown","paddlepaddle-paddleocr","stirling-tools-stirling-pdf","tesseract-ocr-tesseract"]}],"blockers":["Permission surface: shell or command execution, filesystem or document access"],"warnings":["Trust score: Good trust signals with a few areas worth checking before rollout.","Audit score: Needs review","Agent safety gate: Sparse or mixed signals. Useful for discovery, but not for autonomous installation.","High-risk permission hints: Shell or command execution","Permission surface may require sandboxing","Repository appears stale","Repository looks stale","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Recent maintenance: 2y since push","Permission surface: shell or command execution, filesystem or document access"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"do_not_use_when":["teams that require actively maintained dependencies","production agents without a repository review","Repository looks stale","High-risk permission hints: Shell or command execution","Permission surface may require sandboxing","Repository appears stale","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access"],"alternatives":[{"slug":"microsoft-markitdown","name":"Markitdown","url":"https://www.openagentskill.com/skills/microsoft-markitdown","stars":156110,"install_command":"npx skills add microsoft/markitdown","trust_score":90,"audit_score":92},{"slug":"paddlepaddle-paddleocr","name":"PaddleOCR","url":"https://www.openagentskill.com/skills/paddlepaddle-paddleocr","stars":83080,"install_command":"npx skills add PaddlePaddle/PaddleOCR","trust_score":94,"audit_score":95},{"slug":"stirling-tools-stirling-pdf","name":"Stirling PDF","url":"https://www.openagentskill.com/skills/stirling-tools-stirling-pdf","stars":81218,"install_command":"npx skills add Stirling-Tools/Stirling-PDF","trust_score":87,"audit_score":92},{"slug":"tesseract-ocr-tesseract","name":"Tesseract","url":"https://www.openagentskill.com/skills/tesseract-ocr-tesseract","stars":74690,"install_command":"npx skills add tesseract-ocr/tesseract","trust_score":92,"audit_score":95}],"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"jonschlinkert-markdown-toc","name":"Markdown Toc","description":"API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects.","category":"document-processing","url":"https://www.openagentskill.com/skills/jonschlinkert-markdown-toc","repository":"https://github.com/jonschlinkert/markdown-toc","github_repo":"jonschlinkert/markdown-toc"},"suited_tasks":["Document processing workflows","Claude Code teams","teams that value GitHub adoption signals","Read uploaded files","Extract structured fields","Prepare clean context for downstream agents","Inspect source files","Explain architecture"],"suited_agents":["JavaScript","Markdown","Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add jonschlinkert/markdown-toc","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx skills add jonschlinkert/markdown-toc"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"Markdown Toc\" agent skill from https://github.com/jonschlinkert/markdown-toc. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"Markdown Toc\" as a Claude Code skill from https://github.com/jonschlinkert/markdown-toc. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"Markdown Toc\" from https://github.com/jonschlinkert/markdown-toc into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files. Uses Remarkable to parse markdown. Used by NASA/openmct, Prisma, Joi, Mocha, Sass, Prettier, Orbit DB, FormatJS, Raneto, hapijs/code, webpack-flow, docusaurus, release-it, ts-loader, json-server, reactfire, bunyan, husky, react-easy-state, react-snap, chakra-ui, carbon, alfresco, repolinter, Assemble, Verb, and thousands of other projects."}],"handoff_url":"https://www.openagentskill.com/api/skills/jonschlinkert-markdown-toc/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/jonschlinkert-markdown-toc"},"trust":{"score":80,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"1.8K GitHub stars","repoActivity":"1.8K stars, 712 forks","lastPushed":"2y since push","license":"MIT","repository":"https://github.com/jonschlinkert/markdown-toc","install":"npx skills add jonschlinkert/markdown-toc","installSafety":"standard package or runtime install path","permissionSurface":"shell or command execution, filesystem or document access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["document-processing","markdown","documents","javascript","jonschlinkert","markdown-toc"],"known_risks":["Repository looks stale","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Recent maintenance: 2y since push","Permission surface: shell or command execution, filesystem or document access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":74,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","Repository appears stale","Repository looks stale","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access","Recent maintenance: 2y since push","Permission surface: shell or command execution, filesystem or document access"]},"safety_gate":{"tier":"experimental","label":"Experimental","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Test manually in an isolated workspace and compare against safer alternatives."},"quality":{"score":73,"label":"Strong"},"supply":{"track":"Research and knowledge work","scenario":"Document processing","maintenance":"2y since push","risk":"Needs review"},"alternative_skills":[{"slug":"microsoft-markitdown","name":"Markitdown","url":"https://www.openagentskill.com/skills/microsoft-markitdown","stars":156110,"install_command":"npx skills add microsoft/markitdown","trust_score":90,"audit_score":92},{"slug":"paddlepaddle-paddleocr","name":"PaddleOCR","url":"https://www.openagentskill.com/skills/paddlepaddle-paddleocr","stars":83080,"install_command":"npx skills add PaddlePaddle/PaddleOCR","trust_score":94,"audit_score":95},{"slug":"stirling-tools-stirling-pdf","name":"Stirling PDF","url":"https://www.openagentskill.com/skills/stirling-tools-stirling-pdf","stars":81218,"install_command":"npx skills add Stirling-Tools/Stirling-PDF","trust_score":87,"audit_score":92},{"slug":"tesseract-ocr-tesseract","name":"Tesseract","url":"https://www.openagentskill.com/skills/tesseract-ocr-tesseract","stars":74690,"install_command":"npx skills add tesseract-ocr/tesseract","trust_score":92,"audit_score":95}],"do_not_use_when":["teams that require actively maintained dependencies","production agents without a repository review","Repository looks stale","High-risk permission hints: Shell or command execution","Permission surface may require sandboxing","Repository appears stale","Quality score needs review","Permission surface needs review: shell or command execution, filesystem or document access"],"agent_contract":{"task_input":"Evaluate Markdown Toc before installing it in an AI agent workflow","recommended_action":"Test manually in an isolated workspace and compare against safer alternatives.","install_policy":"review","minimum_review_before_use":["Trust: 80/100 Strong shortlist","Audit: 74/100 Needs review","Safety: 46/100 Avoid automatic install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"jonschlinkert-markdown-toc (Markdown Toc)","install_command":"npx skills add jonschlinkert/markdown-toc","risk_summary":"Needs review; Experimental; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"jonschlinkert-markdown-toc","task":"Evaluate Markdown Toc before installing it in an AI agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/jonschlinkert-markdown-toc","api":"https://www.openagentskill.com/api/agent/skills/jonschlinkert-markdown-toc","audit":"https://www.openagentskill.com/skills/jonschlinkert-markdown-toc/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=jonschlinkert-markdown-toc&task=Evaluate%20Markdown%20Toc%20before%20installing%20it%20in%20an%20AI%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Evaluate%20Markdown%20Toc%20before%20installing%20it%20in%20an%20AI%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Evaluate%20Markdown%20Toc%20before%20installing%20it%20in%20an%20AI%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/jonschlinkert-markdown-toc/install","manifest":"https://www.openagentskill.com/api/registry/manifest/jonschlinkert-markdown-toc"}},"endpoints":{"web":"https://www.openagentskill.com/skills/jonschlinkert-markdown-toc","api":"https://www.openagentskill.com/api/agent/skills/jonschlinkert-markdown-toc","eval":"https://www.openagentskill.com/api/agent/evals?slug=jonschlinkert-markdown-toc","audit":"https://www.openagentskill.com/skills/jonschlinkert-markdown-toc/audit","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Evaluate%20Markdown%20Toc%20before%20installing%20it%20in%20an%20AI%20agent%20workflow&agent=codex&max_risk=medium"}},"meta":{"endpoint":"/api/agent/evals","mode":"skill_eval","purpose":"Pre-install eval contract for a single skill. Agents should read this before installing a reusable skill.","generated_at":"2026-07-04T01:56:58.680Z"}}