Files

vitya fdc94e08cf refactor(using-markitdown): rewrite MCP→CLI, drop Docker section v1.0.1

Replace all mcp__markitdown__convert_to_markdown invocations with the
native `markitdown <path|url>` CLI (v0.1.6, on PATH). Outputs to stdout
or `-o <file>`; sees the full host filesystem, so the Docker bind-mount
caveat (host→container file:// translation, [Errno 2] /c:/Users/...) is
gone and that whole section is removed. Updated the ingest pattern (-o
straight into .wiki/raw/), gotchas table (command-not-found → check
`markitdown --version`), and contrast table header (CLI, not MCP).
Description triggers unchanged. PATCH bump 1.0.0→1.0.1; dist artifact
rebuilt.

Decommissioned the Docker MCP containers: no container is named
`markitdown-mcp` (the server spawns anonymous ones from
markitdown-mcp:latest, 3 had piled up); removed all by image ancestor.
Left mcpServers.markitdown in ~/.claude.json untouched (out of scope) —
flagged as a follow-up in the concept page.

Wiki: concepts/using-markitdown-cli-migration.md + index + log.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-09 20:48:18 +03:00

8.2 KiB

Raw Blame History

Wiki Index

Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page.

Overview

overview.md — what claude-skills is, layout, how to navigate

Entities

Concepts

active-platform-decision.md — why active-platform is a skill (not a memory entry); why default = Windows; how it's wired into project-bootstrap
bootstrap-claude-md-merge.md — project-bootstrap@1.3.0 — Step 5 upgrade path becomes idempotent merge (read → diff vs template → confirm → append missing); fixes silent gap where pre-1.2.0 projects never picked up new canonical triggers (check across all projects, we're on Windows)
bootstrap-skill-deps-check.md — project-bootstrap@1.7.0 — Step 5.6 collapses the per-skill "detect-and-recommend" mirror shape into one generic trigger → fulfiller table walker (skill vs plugin kind, never auto-install); subsumes the deferred [bootstrap-recommend-projects-meta] and the existing superpowers-only detector
bootstrap-manifest.md — record of which project-bootstrap / setup-wiki / setup-tasks versions initialized this project's .wiki/ and .tasks/ layout (overwritten on re-bootstrap; history in git)
build-notes.md — why build.ps1 exists alongside build.sh; PS 5.1 backslash-in-zip gotcha; how to extract a .skill
install-cross-platform.md — paired-script parity contract for install.{ps1,sh} AND build.{ps1,sh}; rationale for the --prune / -Prune flag (combined-with-action, global-scan, default-off); install-side prunes target dirs, build-side prunes dist/*.skill files
install-portability.md — install.sh / build.sh rewritten to drop mapfile (bash 4+) and find -printf (GNU only) so stock macOS (bash 3.2 + BSD find) works
context7-setup.md — switched context7 from manual MCP entries to the official plugin; API key in .mcp.json as --api-key; now also captured as setup-context7 skill (one-time install/migrate flow with key discovery)
projects-meta-skills.md — setup-projects-meta + using-projects-meta skill pair for the local projects-meta-mcp stdio server (cross-project tasks + shared Gitea wiki); local-first rule + two-step mutation pattern
project-discipline-design.md — design for project-discipline (four cross-project rules: conventions-over-defaults, master-only, semver-bumping, ask-before-push)
pulling-before-work-design.md — design for the pulling-before-work skill (mode-3 + skip-on-dirty)
repo-layout.md — flat skills/, committed dist/, bash + PowerShell scripts; install model
skill-versioning.md — why infra skills carry version: <semver> in frontmatter and how project-bootstrap records them in a per-project manifest
skill-vs-plugin.md — when a bare SKILL.md is enough vs when you actually need a plugin (slash commands, hooks, sub-agents, MCP servers); concrete breakdown of superpowers
wiki-realignment.md — fixing project-bootstrap to create the Karpathy-canonical wiki layout
interns-design — interns-design
compress-dedup.md — skills/compress/ deleted as a byte-identical dupe of skills/caveman-compress/; canonical kept for README + SECURITY + caveman-toolkit branding; better Process-step wording ported across; version: 1.0.0 added to caveman-compress frontmatter
active-platform-eval-design.md — spec for eval-driven tuning of active-platform: combine the two ⚪ tasks into one workstream, 20-query cross-platform eval set (≥3 per OS + near-miss negatives), run_loop.py autoloop in parallel with manual body sweep (WSL / BSD / ambiguity), version 1.0.0 → 1.1.0 (MINOR). Status: paused after design + pre-flight check, before eval-set authorship
interns-repo-read-design — interns-repo-read-design
hermes-skills-rollout-design — hermes-skills-rollout-design
tdd-criteria-design — tdd-criteria-design
project-bootstrap-meta-isolation.md — project-bootstrap@1.11.0 — Step 1 ships meta-isolation block in .gitignore (!.claude/, !.tasks/, !.wiki/, ...) so own greenfield/upgrade projects re-enable agent meta-paths against global core.excludesFile cutter. Marker-based append-only on existing files; smoke-tested with negative control
interns-grep-audit-design — interns-grep-audit-design
session-handoff-skill-design.md — design rationale for the session-handoff skill (sliding overwrite into .tasks/NEXT_SESSION.md, phrase whitelist + substantive-commit heuristic, optional PostToolUse hook for harness-side determinism, orient+ask default, project scope, cluster 7/7 closure)
using-tasks-session-break.md — using-tasks v1.2.0 session_break marker: task-author-set boolean/string flag; after a task closes 🟢, before tasks_claim_next, an autonomous agent prints the verbatim SESSION BOUNDARY line and stops instead of chaining the next task. Absent → unchanged
delegate-task-session-break.md — delegate-task v0.2.2 — authoring side of the session_break marker (consumer = using-tasks-session-break): pre-flight Q6 + optional template field session_break: true | "<hint>"; three set-it cases (domain-switch / milestone / heavy infra); not a default
delegate-task-review-weight.md — delegate-task v0.2.3 — Step 5 review-task now sets explicit weight, inherited from impl with a needs-claude floor (impl needs-human→review needs-human; cheap-ok→needs-claude). Fixes the reconciler skipping weightless review tasks (root cause of manual patch c0af151)
using-system-snapshot-design.md — using-system-snapshot v0.1.0 — thin read-only skill wrapping the single mcp__projects-meta__meta_system_snapshot call (poller + local docker + cached task summary); replaces scattered tasklist/docker ps/manual meta_status; core rule = no liveness claim without calling the tool this turn; three-line output; defers deep docker to using-vds-ops and precise tasks to using-projects-meta
using-tasks-status-archival.md — using-tasks v1.3.0 done-task archival rule (≥10 🟢 → .tasks/archive/YYYY-MM.md) fixes STATUS.md bloat; documents why tasks_get_status (single-task, by slug) / tasks_aggregate (cross-project cache) can't replace the orientation board-read, so the literal task instruction was not followed
delegate-task-negative-trigger-fp.md — delegate-task v0.2.1 FP fix: «создать задачу себе» stem-matched the «создать задачу на агента» positive trigger; abstract "does NOT apply when doing the work yourself" carve-out loses to literal stem-match under the 1%-rule → made the negative literal + routed (→ using-tasks). Verified pos 5/5, neg 4/5 (was 0/5)
using-markitdown-cli-migration.md — using-markitdown v1.0.0→v1.0.1 (PATCH): rewrote from the Docker-based mcp__markitdown__convert_to_markdown MCP tool to the native markitdown CLI (0.1.6, on PATH); dropped the host→container file:// mount caveat; container decommission is by image ancestor (--filter ancestor=markitdown-mcp:latest), not by the non-existent name markitdown-mcp

8.2 KiB

Raw Blame History

Wiki Index

Overview

Entities

Concepts

Packages

Sources

8.2 KiB Raw Blame History

Wiki Index

Overview

Entities

Concepts

Packages

Sources

8.2 KiB

Raw Blame History