{"schema_version":1,"workflow_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","workflow_title":"MarkItDown — Convert Any Document to Markdown","page_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","raw_url":"https://tokrepo.com/raw/markitdown-convert-any-document-markdown-55fe10f5","metadata_url":"https://tokrepo.com/metadata/markitdown-convert-any-document-markdown-55fe10f5.json","install_plan_url":"https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=55fe10f5-e743-40da-9da0-49fadf6e73c7&target=codex","recommended_install":{"schema_version":1,"status":"stage","policy":"stage_only","install_mode":"stage_only","target":"codex","command":"npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 --target codex","dry_run_command":"npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 --target codex --dry-run --json","runtime_commands":{"codex":"npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 --target codex","gemini":"npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 --target gemini","project":"npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7"},"prompt":"Install and make this TokRepo asset usable: \"MarkItDown — Convert Any Document to Markdown\".\n\nPage: https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5\nUUID: 55fe10f5-e743-40da-9da0-49fadf6e73c7\nTarget adapter: codex\nPolicy/mode: stage_only / stage_only\n\nRead these machine-facing entry points first:\n- metadata: https://tokrepo.com/metadata/markitdown-convert-any-document-markdown-55fe10f5.json\n- install contract: https://tokrepo.com/install-contract/markitdown-convert-any-document-markdown-55fe10f5.json\n- install plan: https://api.tokrepo.com/api/v1/tokenboard/workflows/install-plan?uuid=55fe10f5-e743-40da-9da0-49fadf6e73c7&target=codex\n- raw content: https://tokrepo.com/raw/markitdown-convert-any-document-markdown-55fe10f5\n\nCommands:\n- choose the current runtime; do not use unsupported CLI targets.\n- Codex: npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 --target codex\n- Gemini CLI: npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 --target gemini\n- Claude Code / project agent: run npx -y tokrepo@latest install 55fe10f5-e743-40da-9da0-49fadf6e73c7 from the project root; add `--dry-run --json` first to inspect the plan.\n- add `--dry-run --json` to the chosen command first; after the plan allows it, run the chosen command.\n\nExecution rules:\n1. Run the install command to stage the asset safely.\n2. Read the staged README, install-plan, and entrypoint files.\n3. Activate scripts, MCP config, or global config only after user confirmation.\n4. Verify usability with the install-plan post_verify checks and the asset README.\n\nReport back with changed files, verification result, and how to use the asset next.","next_steps":["Run the install command to stage the asset safely.","Read the staged README, install-plan, and entrypoint files.","Activate scripts, MCP config, or global config only after user confirmation.","Verify usability with the install-plan post_verify checks and the asset README."],"success_check":["The asset is safely staged.","The agent can give clear activation steps from the staged content."]},"agent_metadata":{"asset_kind":"mcp_config","target_tools":["claude_code","codex","cursor","gemini_cli","windsurf"],"install_mode":"stage_only","entrypoint":"markitdown.md","risk_profile":{"executes_code":false,"modifies_global_config":true,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"dependencies":{"npm":[],"pip":[],"brew":[],"system":[]},"content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","verification":{"commands":[],"expected_files":["markitdown.md"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools includes codex","asset_kind mcp_config","install_mode stage_only","policy stage_only","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","trust community"],"asset_kind":"mcp_config","install_mode":"stage_only"},"trust":{"author_trust_level":"community","verified_publisher":false,"asset_signed_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","signature_status":"hash_only","install_count":0,"report_count":0,"dangerous_capability_badges":["mcp_config","modifies_global_config","stage_only"],"review_status":"unreviewed","signals":["asset has usage views","content hash available"]},"provenance":{"owner_uuid":"f321eb5f-b4b0-4a57-9168-f97b7579598f","owner_name":"Microsoft AI","source_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","visibility":1,"created_at":"2026-04-02 11:19:56","updated_at":"2026-06-14 05:08:20"},"target_adapter":{"target":"codex","adapter":"skill-directory","root":"~/.codex/skills","entrypoint":"SKILL.md","manifest_path":"~/.codex/tokrepo/install-manifest.json","staging_root":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"install_plan":{"schema_version":2,"target":"codex","asset_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","asset_title":"MarkItDown — Convert Any Document to Markdown","source_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","install_mode":"stage_only","entrypoint":"markitdown.md","preconditions":[{"type":"target_supported","status":"pass","message":"codex install target is supported"},{"type":"install_root","status":"pass","message":"~/.codex/skills for activated assets; ~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7 for staged assets"},{"type":"target_tool_metadata","status":"pass","message":"metadata allows codex"},{"type":"content_hash","status":"pass","message":"asset metadata includes content_hash"},{"type":"trust_policy","status":"warn","message":"low trust publisher plus dangerous capability requires staging"},{"type":"policy_decision","status":"warn","message":"stage_only for 55fe10f5-e743-40da-9da0-49fadf6e73c7 (stage_only)"}],"actions":[{"type":"stage_file","path":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7/markitdown.md","source_name":"markitdown.md","sha256":"fadc7f3cdd7f30db00a597781c0ed762e2998c0e9dbecdd88c9eeae633900fcf","bytes":3942,"risk":{"executes_code":false,"modifies_global_config":true,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"if_exists":"overwrite"}],"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","low trust publisher plus dangerous capability requires staging"]},"requires_confirmation":false,"rollback":[{"type":"remove_file","path":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7/markitdown.md"}],"post_verify":[{"type":"file_sha256","path":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7/markitdown.md","sha256":"fadc7f3cdd7f30db00a597781c0ed762e2998c0e9dbecdd88c9eeae633900fcf"},{"type":"expected_file","path":"markitdown.md"}],"metadata":{"asset_kind":"mcp_config","target_tools":["claude_code","codex","cursor","gemini_cli","windsurf"],"install_mode":"stage_only","entrypoint":"markitdown.md","risk_profile":{"executes_code":false,"modifies_global_config":true,"requires_secrets":[],"uses_absolute_paths":false,"network_access":false},"dependencies":{"npm":[],"pip":[],"brew":[],"system":[]},"content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","verification":{"commands":[],"expected_files":["markitdown.md"]}},"agent_fit":{"target":"codex","score":17,"status":"stage_only","policy":"stage_only","why":["target_tools includes codex","asset_kind mcp_config","install_mode stage_only","policy stage_only","asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","trust community"],"asset_kind":"mcp_config","install_mode":"stage_only"},"trust":{"author_trust_level":"community","verified_publisher":false,"asset_signed_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","signature_status":"hash_only","install_count":0,"report_count":0,"dangerous_capability_badges":["mcp_config","modifies_global_config","stage_only"],"review_status":"unreviewed","signals":["asset has usage views","content hash available"]},"provenance":{"owner_uuid":"f321eb5f-b4b0-4a57-9168-f97b7579598f","owner_name":"Microsoft AI","source_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","visibility":1,"created_at":"2026-04-02 11:19:56","updated_at":"2026-06-14 05:08:20"},"target_adapter":{"target":"codex","adapter":"skill-directory","root":"~/.codex/skills","entrypoint":"SKILL.md","manifest_path":"~/.codex/tokrepo/install-manifest.json","staging_root":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7","install_modes":["single","bundle","split","stage_only"],"activates_files":true},"evidence_bundle":{"acceptance_gate":{"recommended_action":"stage_or_request_confirmation","rule":"Agents should only activate an asset after evidence_bundle.integrity, policy_compatibility, rollback, and post_verify have been inspected.","status":"caution"},"asset_title":"MarkItDown — Convert Any Document to Markdown","asset_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","eval_evidence":["https://tokrepo.com/evals/install-safety.json","https://tokrepo.com/evals/trust-evidence-coverage.json","https://tokrepo.com/evals/handoff-quality.json"],"generated_at":"2026-06-13T21:08:22Z","integrity":{"content_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","declared_content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","file_count":1,"hash_algorithm":"sha256","install_plan_hash":"78f1704bc8a8813c671e2922fbfb64b158dfae65169a31cb8d9c968fa18114d9"},"policy_compatibility":{"permission_envelope":{"destructive":false,"executes_code":false,"file_count":1,"filesystem_write":["~/.codex/tokrepo/staged"],"global_config_write":true,"network":false,"requires_secrets":[],"uses_absolute_paths":false},"policy_decision":{"decision":"stage_only","requires_confirmation":false,"reasons":["asset_kind mcp_config is not activated directly for Codex","install_mode is stage_only","risk_profile.modifies_global_config is true","low trust publisher plus dangerous capability requires staging"]},"requires_confirmation":false,"target":"codex","trust_score_v2":{"recommended_action":"stage_or_request_confirmation","status":"caution","trust_score":60}},"provenance":{"asset_kind":"mcp_config","asset_title":"MarkItDown — Convert Any Document to Markdown","asset_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","computed_bundle_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","created_at":"2026-04-02 11:19:56","generated_at":"2026-06-13T21:08:22Z","install_plan_hash":"78f1704bc8a8813c671e2922fbfb64b158dfae65169a31cb8d9c968fa18114d9","owner_name":"Microsoft AI","owner_uuid":"f321eb5f-b4b0-4a57-9168-f97b7579598f","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","updated_at":"2026-06-14 05:08:20","visibility":1},"sbom":{"asset_kind":"mcp_config","asset_title":"MarkItDown — Convert Any Document to Markdown","asset_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","capability_flags":{"destructive":false,"executes_code":false,"modifies_global_config":true,"network_access":false,"requires_secrets":[]},"content_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":3942,"path":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7/markitdown.md","role":"supporting_file","sha256":"fadc7f3cdd7f30db00a597781c0ed762e2998c0e9dbecdd88c9eeae633900fcf","source_name":"markitdown.md"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"schema":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json","schema_version":1,"schemas":{"asset_verification":"https://tokrepo.com/schemas/asset-verification.schema.json","evidence_bundle":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json","install_plan":"https://tokrepo.com/schemas/install-plan.schema.json","provenance":"https://tokrepo.com/schemas/provenance.schema.json","sbom":"https://tokrepo.com/schemas/agent-evidence-bundle.schema.json#/properties/sbom"},"signature_evidence":{"content_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","hash_algorithm":"sha256","install_plan_hash":"78f1704bc8a8813c671e2922fbfb64b158dfae65169a31cb8d9c968fa18114d9","schema_version":1,"signed_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","status":"hash_only","verification_notes":["hash_only evidence proves content integrity but not publisher identity unless an external signature verifies it"]},"source_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","target":"codex"},"sbom":{"asset_kind":"mcp_config","asset_title":"MarkItDown — Convert Any Document to Markdown","asset_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","capability_flags":{"destructive":false,"executes_code":false,"modifies_global_config":true,"network_access":false,"requires_secrets":[]},"content_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","dependencies":{"brew":[],"mcp":[],"npm":[],"pip":[],"system":[]},"files":[{"bytes":3942,"path":"~/.codex/tokrepo/staged/55fe10f5-e743-40da-9da0-49fadf6e73c7/markitdown.md","role":"supporting_file","sha256":"fadc7f3cdd7f30db00a597781c0ed762e2998c0e9dbecdd88c9eeae633900fcf","source_name":"markitdown.md"}],"format":"SBOM-lite","install_mode":"stage_only","schema_version":1,"target":"codex"},"signature_evidence":{"content_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","hash_algorithm":"sha256","install_plan_hash":"78f1704bc8a8813c671e2922fbfb64b158dfae65169a31cb8d9c968fa18114d9","schema_version":1,"signed_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","status":"hash_only","verification_notes":["hash_only evidence proves content integrity but not publisher identity unless an external signature verifies it"]},"provenance_v2":{"asset_kind":"mcp_config","asset_title":"MarkItDown — Convert Any Document to Markdown","asset_uuid":"55fe10f5-e743-40da-9da0-49fadf6e73c7","computed_bundle_hash":"f5f6a1497599dd8baebe7666a8df79c2b9886feedc5988b0ab471fbbea64ba68","content_hash":"d58dfbec4f32d2f939f55e72bac2ddb80e52e371961ea46795d1f308ea3b191f","created_at":"2026-04-02 11:19:56","generated_at":"2026-06-13T21:08:22Z","install_plan_hash":"78f1704bc8a8813c671e2922fbfb64b158dfae65169a31cb8d9c968fa18114d9","owner_name":"Microsoft AI","owner_uuid":"f321eb5f-b4b0-4a57-9168-f97b7579598f","parent_uuid":"","schema_version":2,"source":"tokrepo_asset","source_url":"https://tokrepo.com/en/workflows/markitdown-convert-any-document-markdown-55fe10f5","updated_at":"2026-06-14 05:08:20","visibility":1},"transitive_dependencies":null}}