queryable-markdown
Installation
SKILL.md
Queryable Markdown
Use the compact agent commands for normal work. Use the stable JSON commands only for automation or when compact output says full details are required.
Resolve SKILL_DIR to this skill directory before invoking
$SKILL_DIR/scripts/mdq.py.
Route the Operation
| Need | Command or workflow |
|---|---|
| Read one exact record | get <document> --id <id> |
| Find records across files or directories | find <path>... --id <id> or --text <text> |
| Run a declared v2 query | run <document> --query <name> --value <value> --output compact |
| Update existing label scalars | set preview, then repeat with --apply |
| Verify an authorized edit | check <document> --tier content|structure|contract |
| Create, convert, or repair a contract | Read the contract references below first |
| Feed another program | Use query, search, scan, or run with JSON output |