Agent skill

Qmd

by XRSec in XRSec/Screen-Remote

Search and retrieve Screen Remote Android and macOS Wiki documentation through the local QMD BM25 index, and audit bilingual Wiki pairing and navigation integrity.

Apache-2.0Auto-check passedWriting & Content

Install Qmd

skills CLI
$ npx skills add XRSec/Screen-Remote --skill qmd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install XRSec/Screen-Remote qmd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/XRSec/Screen-Remote.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/qmd .claude/skills/qmd && rm -rf skills-src

Use ~/.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/

Facts

Skill name
qmd
GitHub stars
183
Token cost
~802 tokens
SKILL.md length
325 words
Files
4 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
Apache-2.0

At a glance

Search and retrieve Screen Remote Android and macOS Wiki documentation through the local QMD BM25 index, and audit bilingual Wiki pairing and navigation integrity.

  • Users ask to find project documentation
  • SKILL.md covers Screen Remote workflow and Bilingual routing
  • Runs JavaScript scripts from its folder; calls node and git
  • Compare either platform Wiki

What it does

Qmd is an agent skill from XRSec/Screen-Remote. Search and retrieve Screen Remote Android and macOS Wiki documentation through the local QMD BM25 index, and audit bilingual Wiki pairing and navigation integrity. Use when users ask to find project documentation, inspect or compare either platform Wiki, locate a documented interface or procedure, answer from indexed local Markdown, maintain bilingual Wiki pages, or verify language counterparts and sidebar links.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml` and `references/mcp-setup.md`).

It sits in Writing & Content, covering Translation. It works with Android and macOS. The repository describes itself as: Ported scrcpy for mobile platforms, to remotely control Android devices on your Android phone. The licence is Apache-2.0.

When your agent uses it

  • Users ask to find project documentation
  • Compare either platform Wiki
  • Locate a documented interface
  • Answer from indexed local Markdown

Example prompts

  • “/qmd”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 35bb019. 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

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Qmd loads about 802 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 325 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~802
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from XRSec/Screen-Remote at commit 35bb019, republished under its Apache-2.0 licence (© XRSec). 325 words, ~802 tokens.

Download SKILL.mdSave it as .claude/skills/qmd/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
qmd
description
Search and retrieve Screen Remote Android and macOS Wiki documentation through the local QMD BM25 index, and audit bilingual Wiki pairing and navigation integrity. Use when users ask to find project documentation, inspect or compare either platform Wiki, locate a documented interface or procedure, answer from indexed local Markdown, maintain bilingual Wiki pages, or verify language counterparts and sidebar links.

QMD - Query Markdown Documents

This installed skill is intentionally a small bootstrap so it does not go stale when the qmd package updates.

Load the full, version-matched QMD instructions from the CLI:

!qmd skill show

If your agent does not support bang-command expansion, run:

bash
qmd skill show

Then follow those instructions. In short: search first, fetch full sources with qmd get or qmd multi-get, and answer from retrieved text rather than snippets.

Screen Remote workflow

Before the first search in a turn, refresh only when the two Wiki trees changed:

bash
node "$(git rev-parse --show-toplevel)/.codex/hooks/qmd-wiki-sync.mjs"

Use BM25 keyword search by default. Do not run qmd query, qmd vsearch, or qmd embed unless the user explicitly requests semantic search; those modes can download local models.

Search both platforms by omitting -c:

bash
qmd search "scrcpy resolution" --format files --full-path

Restrict a platform only when the request is platform-specific:

bash
qmd search "ADB authentication" -c screen-remote-android-wiki --format files --full-path
qmd search "SwiftUI session window" -c screen-remote-macos-wiki --format files --full-path

After identifying the strongest result, retrieve its full source with qmd get. The configured collections are:

  • screen-remote-android-wiki → external/wiki-android/
  • screen-remote-macos-wiki → external/wiki-macos/

Bilingual routing

  • Treat a -EN.md suffix as an explicit English signal when it exists. Do not assume an unsuffixed ASCII filename is English; URL-Scheme-Automation.md is Chinese while URL-Scheme-Automation-EN.md is English.
  • Treat reciprocal [English](...) and [中文](...) links near the top of a page as the complete bilingual-pair registry.
  • Treat _Sidebar.md as curated primary navigation, not an exhaustive page registry. Validate every listed pair, but do not add every detail page merely to make the sidebar exhaustive.
  • When both translations are search candidates, return or read the English page by default and collapse the Chinese counterpart into it. Do not count translations as independent corroboration.
  • The first-prompt session lookup returns paths only. Read a selected source later when the task actually needs its facts.

After changing either Wiki's pages, language links, filenames, or sidebar, run the deterministic audit:

bash
node .agents/skills/qmd/scripts/audit-bilingual-wiki.mjs

Use --verbose only when the compact summary reports errors or when reviewing which valid pairs are intentionally absent from primary navigation. Fix every reported error before declaring Wiki maintenance complete. An unlisted count is informational, not a failure.

© XRSec, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in .agents/skills/qmd of XRSec/Screen-Remote.

  • SKILL.md
  • agents/openai.yaml
  • references/mcp-setup.md
  • scripts/audit-bilingual-wiki.mjs

Open the folder on GitHubat commit 35bb019

Compare with similar skills

Qmd 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.

Qmd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qmd this skillXRSec/Screen-Remote183—~802Automated safety check: PassApache-2.0
Add Stringsparawanderer/OpenTagViewer418—~1.2kAutomated safety check: PassMIT
Update TranslationsInfomaniak/desktop-kDrive120—~2.9kAutomated safety check: PassGPL-3.0
Translate Android LocaleCodename-11/hermes-relay314—~365Automated safety check: PassMIT
Cometchat Android V6 Extensionscometchat/cometchat-skills130—~1.4kAutomated safety check: PassMIT
Natural Languagedpearson2699/swift-ios-skills1.2k1 repos~3.5kAutomated safety check: PassCustom licence

Similar skills

  • Add Strings

    parawanderer/OpenTagViewer

    Add or back-fill user-facing Android strings across all locales in OpenTagViewer.

    418 GitHub stars~1.2k tokensUpdated 19 days ago
    Writing & ContentAuto-check passed
  • Update Translations

    Infomaniak/desktop-kDrive

    Update kDrive app translations: GUI strings (macOS and Windows redesigns) are imported from the Loco platform with Infomaniak's importloco CLI (one config per GUI is already committed in the repo)…

    120 GitHub stars~2.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translate Android Locale

    Codename-11/hermes-relay

    Generate, critique, install, and validate AI-assisted Android string-resource translations for Hermes-Relay.

    314 GitHub stars~365 tokensUpdated today
    Writing & ContentAuto-check passed
  • Cometchat Android V6 Extensions

    cometchat/cometchat-skills

    Turn on CometChat Dashboard extensions in an Android v6 app — stickers, polls, collaborative whiteboard and document, message translation, link preview, thumbnail generation, message shortcuts — and…

    130 GitHub stars~1.4k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Natural Language

    dpearson2699/swift-ios-skills

    Tokenize, tag, and analyze natural language text using Apple's NaturalLanguage framework and translate between languages with the Translation framework.

    1.2k GitHub starsUsed in 1 repo~3.5k tokens
    AI & LLM EngineeringAuto-check passed
  • Gearcoleco Romhacking

    drhelius/Gearcoleco

    Hack, modify, and translate ColecoVision and Super Game Module ROMs using the Gearcoleco emulator MCP server.

    141 GitHub stars~3.9k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

Works with

Questions about Qmd

What does Qmd do?

Search and retrieve Screen Remote Android and macOS Wiki documentation through the local QMD BM25 index, and audit bilingual Wiki pairing and navigation integrity. Qmd is an agent skill from XRSec/Screen-Remote. Search and retrieve Screen Remote Android and macOS Wiki documentation through the local QMD BM25 index, and audit bilingual Wiki pairing and navigation integrity.

When should I use Qmd?

Qmd fits situations like: users ask to find project documentation; compare either platform Wiki; locate a documented interface; answer from indexed local Markdown.

How do I install Qmd in Claude Code?

Run `npx skills add XRSec/Screen-Remote --skill qmd -a claude-code`. Or copy the skill folder (.agents/skills/qmd in XRSec/Screen-Remote) into .claude/skills/qmd in your project. Claude Code loads it when a task matches its description.

How do I install Qmd in Codex?

Run `npx skills add XRSec/Screen-Remote --skill qmd -a codex`. Or copy the skill folder (.agents/skills/qmd in XRSec/Screen-Remote) into .agents/skills/qmd in your project. Codex loads it when a task matches its description.

Can I use Qmd 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 XRSec/Screen-Remote --skill qmd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qmd, .gemini/skills/qmd, .github/skills/qmd and .opencode/skills/qmd in your project.

What does Qmd need to run?

Going by SKILL.md and its folder, Qmd needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and git). Our summary lists: Node.js.

Does Qmd access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Qmd 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Qmd use?

Qmd is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qmd use?

About 802 tokens (SKILL.md is roughly 3.2k 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 499 tokens, read only when the agent opens those files.

What are the alternatives to Qmd?

Skills that share tags, products or a category with Qmd: Add Strings (parawanderer/OpenTagViewer, 418 stars), Update Translations (Infomaniak/desktop-kDrive, 120 stars), Translate Android Locale (Codename-11/hermes-relay, 314 stars) and Cometchat Android V6 Extensions (cometchat/cometchat-skills, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qmd?

XRSec (a GitHub organization) maintains it in XRSec/Screen-Remote, which has 183 GitHub stars. The repository was last updated on August 30, 2026.

Source: XRSec/Screen-Remote on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.