Skills Vote

What it does

Example prompts

• “/skills-vote”

Requirements

• Python 3
• A Bash shell
• PowerShell
• A credential in SKILLS_VOTE_API_KEY
• A credential in GITHUB_TOKEN

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Confirm SKILLS_VOTE_API_KEY is set
2. 2Verify that uv is installed: uv -V
3. 3If uv is missing, install it from the official docs.
4. 4Verify again: uv -V

What it can do on your machine

Read from SKILL.md and the folder at commit 55ea783. 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 8 files in scripts/ (Python, PowerShell and Shell), which the agent can run.

  Shell commands in SKILL.md call:

  • uv
  • sh
  • bash
  • curl
  • wget
  • codex
  • claude
  • cursor
  • gemini
  • opencode

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

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • astral.sh

  Also links to:

  • docs.astral.sh

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • SKILLS_VOTE_API_KEY
  • GITHUB_TOKEN
  • GH_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skills Vote loads about 1.2k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 573 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~57

When it runs · the whole SKILL.md, loaded when a task matches

~1.2k

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

• NotePipes a well-known installer script into a shellSKILL.md:36

  - If curl is available, `curl -LsSf https://astral.sh/uv/install.sh | sh`

• NotePipes a well-known installer script into a shellSKILL.md:37

  - Otherwise `wget -qOhttps://astral.sh/uv/install.sh | sh`

• NotePipes a well-known installer script into a shellSKILL.md:38

  `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`

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 MemTensor/skills-vote at commit 55ea783, republished under its MIT licence (© MemTensor). 573 words, ~1,220 tokens.

name

skills-vote

description

Find the most relevant external agent skills for the current task, then submit grounded feedback about which skills were actually used and useful in the same session. Whenever you start a task, use this skill first.

metadata.version

1.1.0

uv run -qq scripts/recommend.py <<'EOF'
{
  "query": "Add integration tests for a FastAPI skill recommendation flow, mock the gateway, and verify the returned skills and feedback flow.",
  "client_name": "codex",
  "client_version": "0.117.0",
  "download_dir": ".skills_vote/"
}
EOF

© MemTensor, MIT. 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 10 other files (scripts) in integration/skills/skills-vote of MemTensor/skills-vote.

• SKILL.md
• .gitignore
• docs/feedback_guide.md
• scripts/check_api_key.ps1
• scripts/check_api_key.sh
• scripts/download.py
• scripts/feedback.py
• scripts/models.py
• scripts/prompt.py
• scripts/recommend.py
• scripts/utils.py

Open the folder on GitHubat commit 55ea783