Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
This skill SHOULD be used for structured extraction or batch queries against JSON (use jq), YAML (use yq), or Markdown (use mq), and for advanced text search with ripgrep flags or pipe composition…
Install Query Files
$ npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install kylesnowschwartz/SimpleClaude query-files --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/sc-skills/skills/query-files .claude/skills/query-files && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "query-files" agent skill from https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-files into .claude/skills/query-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "query-files", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-filesType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install kylesnowschwartz/SimpleClaude query-files --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/sc-skills/skills/query-files .agents/skills/query-files && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "query-files" agent skill from https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-files into .agents/skills/query-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "query-files", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install kylesnowschwartz/SimpleClaude query-files --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/sc-skills/skills/query-files .cursor/skills/query-files && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "query-files" agent skill from https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-files into .cursor/skills/query-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "query-files", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/kylesnowschwartz/SimpleClaude.git --path plugins/sc-skills/skills/query-files--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install kylesnowschwartz/SimpleClaude query-files --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/sc-skills/skills/query-files .gemini/skills/query-files && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "query-files" agent skill from https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-files into .gemini/skills/query-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "query-files", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install kylesnowschwartz/SimpleClaude query-filesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/sc-skills/skills/query-files .github/skills/query-files && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "query-files" agent skill from https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-files into .github/skills/query-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "query-files", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install kylesnowschwartz/SimpleClaude query-files --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/kylesnowschwartz/SimpleClaude.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/sc-skills/skills/query-files .opencode/skills/query-files && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "query-files" agent skill from https://github.com/kylesnowschwartz/SimpleClaude/tree/main/plugins/sc-skills/skills/query-files into .opencode/skills/query-files/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "query-files", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
query-files- GitHub stars
- 114
- Token cost
- ~1.2k tokens
- SKILL.md length
- 233 words
- Files
- 5 (incl. references)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- None found
At a glance
This skill SHOULD be used for structured extraction or batch queries against JSON (use jq), YAML (use yq), or Markdown (use mq), and for advanced text search with ripgrep flags or pipe composition…
- Tasks that involve Document parsing
- SKILL.md covers Route by Task, jq: JSON Extraction, yq: YAML Extraction and mq: Markdown Extraction, plus 3 more sections
- Calls jq, rg and yq
- Tasks that involve Markdown
What it does
Query Files is an agent skill from kylesnowschwartz/SimpleClaude. This skill SHOULD be used for structured extraction or batch queries against JSON (use jq), YAML (use yq), or Markdown (use mq), and for advanced text search with ripgrep flags or pipe composition (use rg).
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/jq-guide.md`, `references/mq-guide.md` and `references/rg-guide.md`).
It sits in Documents & Office, covering Document parsing and Markdown. The repository describes itself as: Practical minimalism for AI assisted programming with Claude Code.
When your agent uses it
- Tasks that involve Document parsing
- Tasks that involve Markdown
Example prompts
- “/query-files”
Requirements
- Docker
What it can do on your machine
Read from SKILL.md and the folder at commit a98f931. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
jqrgyq
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Query Files loads about 1.2k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 233 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 233 words (~1,187 tokens).
“Extract specific data from files using CLI tools instead of built-in Read/Grep. Saves 80-95% of context tokens on large files and enables features the built-in tools lack.”
- name
- query-files
Files
SKILL.md and 4 other files (references) in plugins/sc-skills/skills/query-files of kylesnowschwartz/SimpleClaude.
- SKILL.md
- references/jq-guide.md
- references/mq-guide.md
- references/rg-guide.md
- references/yq-guide.md
Open the folder on GitHubat commit a98f931
Compare with similar skills
Query Files next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Query Files this skillkylesnowschwartz/SimpleClaude | 114 | — | ~1.2k | Automated safety check: Pass | None | |
| MarkitdownImCa0/just-laws | 782 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Huashu Markdown Publishing Pipelinealchaincyf/huashu-md-html | 907 | — | ~4.8k | Automated safety check: Pass | MIT | |
| Lt2mdlibnyx/LT2MD | 109 | — | ~4.4k | Automated safety check: Pass | AGPL-3.0 | |
| MineruNebutra/MinerU-Skill | 122 | — | ~504 | Automated safety check: Pass | MIT | |
| Final Reviewlucianwhy/final-review | 113 | — | ~1.3k | Automated safety check: Pass | None |
Similar skills
Huashu Markdown Publishing Pipeline
alchaincyf/huashu-md-html
Converts files and web pages into clean Markdown, then turns Markdown into polished HTML, Word, PDF and EPUB using four templates.
Lt2md
libnyx/LT2MD
Convert born-digital, scanned, or mixed PDFs into auditable Markdown while preserving reading order, equations, source-page anchors, and information-bearing images as adjacent non-original text…
Mineru
Nebutra/MinerU-Skill
An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.
Final Review
lucianwhy/final-review
用于期末复习、考前突击、题目生成、知识点辅导、复习资料清洗等场景。基于用户上传课程资料开展工作，优先参考历年真题、老师PPT、平时作业和 Markdown 资料；先用 markitdown 转 Markdown，再清洗材料，最后生成题目、答案和偏考试得分导向的解析。
Doc To Markdown
daymade/claude-code-skills
Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.
More from kylesnowschwartz/SimpleClaude
All 12 skills in this repoSc Gemini Imagegen
kylesnowschwartz/SimpleClaude
Generate and edit images using the Gemini API (Nano Banana).
Sc Claude Md Improver
kylesnowschwartz/SimpleClaude
Audit and improve project memory files (CLAUDE.md, AGENTS.md, .claude.local.md) — assess against a quality rubric, then apply additions and removals.
Sc Hypothesize
kylesnowschwartz/SimpleClaude
A skill your agent uses when multiple plausible approaches must be generated, tested, and compared against constraints before the user chooses.
Sc Socratic
kylesnowschwartz/SimpleClaude
A skill your agent uses when the user is clarifying beliefs, assumptions, goals, or framing before committing to decision or plan.
External Agents
kylesnowschwartz/SimpleClaude
Invoke external AI CLIs (Codex, Gemini) for second opinions, code reviews, or alternative analysis.
Hud First
kylesnowschwartz/SimpleClaude
A skill your agent uses when designing AI features and the real opportunity may be perception support, not delegated conversational work.
Related
Categories
Questions about Query Files
What does Query Files do?
This skill SHOULD be used for structured extraction or batch queries against JSON (use jq), YAML (use yq), or Markdown (use mq), and for advanced text search with ripgrep flags or pipe composition…. Query Files is an agent skill from kylesnowschwartz/SimpleClaude. This skill SHOULD be used for structured extraction or batch queries against JSON (use jq), YAML (use yq), or Markdown (use mq), and for advanced text search with ripgrep flags or pipe composition (use rg).
When should I use Query Files?
Query Files fits situations like: tasks that involve Document parsing; tasks that involve Markdown.
How do I install Query Files in Claude Code?
Run `npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a claude-code`. Or copy the skill folder (plugins/sc-skills/skills/query-files in kylesnowschwartz/SimpleClaude) into .claude/skills/query-files in your project. Claude Code loads it when a task matches its description.
How do I install Query Files in Codex?
Run `npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a codex`. Or copy the skill folder (plugins/sc-skills/skills/query-files in kylesnowschwartz/SimpleClaude) into .agents/skills/query-files in your project. Codex loads it when a task matches its description.
Can I use Query Files in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kylesnowschwartz/SimpleClaude --skill query-files -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/query-files, .gemini/skills/query-files, .github/skills/query-files and .opencode/skills/query-files in your project.
What does Query Files need to run?
Going by SKILL.md and its folder, Query Files needs the command-line tools its instructions call (jq, rg and yq). Our summary lists: Docker.
Does Query Files access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Query Files safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Query Files use?
No licence was found for Query Files or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Query Files use?
About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.
What are the alternatives to Query Files?
Skills that share tags, products or a category with Query Files: Markitdown (ImCa0/just-laws, 782 stars), Huashu Markdown Publishing Pipeline (alchaincyf/huashu-md-html, 907 stars), Lt2md (libnyx/LT2MD, 109 stars) and Mineru (Nebutra/MinerU-Skill, 122 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Query Files?
kylesnowschwartz (a GitHub user) maintains it in kylesnowschwartz/SimpleClaude, which has 114 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 5, 2026.
Source: kylesnowschwartz/SimpleClaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.