Skills

A small collection of practical Agent Skills.

Skills

fable-5-best-practice

Guides agents and users in getting the most out of Claude Fable 5 for ambitious, long-running work. It routes tasks across the Haiku / Sonnet / Opus / Fable tiers, walks a diagnose-before-escalating ladder for effort and model changes, covers Fable-specific API behavior (adaptive thinking, refusal stop reasons, fallback), and keeps progress claims tied to real tool evidence. Volatile facts such as pricing, retention, and beta headers live in a dated references/evidence-notes.md provenance snapshot.

The skill is especially useful when migrating older prompts or skills to Fable 5: it calls out over-constrained legacy prompting, refusal risks, boundary setting, memory files, verifier agents, long-running run design, and long-run communication style.

Install:

npx skills add https://github.com/wquguru/skills --skill fable-5-best-practice

Ask for help with prompts like:

• "Is this task Fable-worthy?"
• "Help me write a Fable 5 prompt for a multi-day coding task."
• "Review this old skill before migrating it to Fable 5."
• "My Fable run missed the acceptance criteria — raise effort or change model?"

gpt-5-6-best-practice

A routing and evaluation overlay for GPT-5.6 in Codex. It optimizes the cost of an accepted result — not the price of a token — across the Sol, Terra, and Luna capability tiers: choosing the initial tier and reasoning-effort lane, diagnosing failures before escalating, keeping prompts and worker packets lean, using subagents economically, and evaluating routes on real work. Benchmark provenance and confidence levels live in references/evidence-notes.md, and references/prompt-patterns.md provides reusable task-prompt and worker-packet templates.

Install:

npx skills add https://github.com/wquguru/skills --skill gpt-5-6-best-practice

Ask for help with prompts like:

• "Which GPT-5.6 tier and effort should this task start on?"
• "This Codex run failed — raise effort, or move from Terra to Sol?"
• "Is Ultra worth it for this task, or should one agent handle it?"
• "Design a worker packet for this subagent."

english-swe-daily

A practical English coach for everyday engineering communication. Built for developers who can already work in English but want to sound less textbook-like and more like a real teammate in standups, Slack threads, 1:1s, code reviews, and meetings.

Many engineers do not struggle with grammar — they struggle with sounding natural. This skill teaches the kind of English people actually use in software teams, with a strong focus on natural phrasing, collaboration tone, and day-to-day workplace situations.

Install:

npx skills add https://github.com/wquguru/skills --skill english-swe-daily

Ask for help with prompts like:

• "Teach me English for standups."
• "Help me sound more natural in Slack."
• "Practice English for code reviews."
• "How do I say this more naturally at work?"
• "Give me today's SWE English session."

pi-setup

Configures Pi Agent (@earendil-works/pi-coding-agent) with DeepSeek V4 (built-in provider) and Ant-Ling Ring-2.6-1T (custom OpenAI-compatible provider), plus a curated extension set, while automatically working around 7 known pitfalls.

It detects before it acts: it probes whether pi is installed, whether config already exists, and where keys live before changing anything. Keys are never written in plaintext — pi config only stores lazy !shell commands and the key stays in the user's original file. Model selection, default model, default thinking tier, and the extension set are all confirmed interactively.

Install:

npx skills add https://github.com/wquguru/skills --skill pi-setup

Trigger it in Claude Code by saying "配置 pi", "setup pi agent", "把 ring/deepseek 配到 pi", or run /pi-setup manually.

Prerequisites:

• Node.js / npm (to install pi)
• A DeepSeek key (in ~/.deepseek or an environment variable)
• An Ant-Ling/Ling key (LING_API_KEY, in a shell rc or environment variable) — only needed when enabling Ring

free-my-cpu

Safely audits CPU, load average, I/O wait, and Docker container pressure on Linux hosts, especially production-like servers over SSH. It follows the same read-only-first posture as free-my-disk: collect repeated samples, separate CPU-bound work from I/O pressure, inspect hot containers and logs, then classify possible fixes by impact before changing anything.

Install:

npx skills add https://github.com/wquguru/skills --skill free-my-cpu

Ask for help with prompts like:

• "Use free-my-cpu to inspect this remote Docker host."
• "Why is this Docker host load average so high?"
• "Find which container is burning CPU."
• "Use this Grafana URL and the last 6 hours to check whether monitoring queries are causing load."

youtube-toolkit

Downloads YouTube videos with yt-dlp and post-processes them with ffmpeg: fetch best-quality streams, convert containers (e.g. AV1/webm → H.264 mp4), extract audio, and burn in translated subtitles with a translator watermark.

It is macOS-first and bakes in the gotchas learned the hard way — chiefly that Homebrew's lean ffmpeg ships without libass/drawtext (so subtitle burn-in needs ffmpeg-full), that YouTube auto-captions are overlapping rolling cues that must be re-segmented before they read cleanly, and that styling via an ASS file avoids the force_style comma-parsing trap. Two helper scripts do the deterministic work: install-tools.sh and burn-subs.sh.

Install:

npx skills add https://github.com/wquguru/skills --skill youtube-toolkit

Ask for help with prompts like:

• "Download this YouTube video to ~/Downloads."
• "Convert it to mp4."
• "Add Chinese subtitles and a @handle 翻译 watermark."

Prerequisites:

• Homebrew (macOS) or apt/pip (Linux)
• yt-dlp and a libass-enabled ffmpeg — install-tools.sh sets both up

Local Development

For local hacking, the Justfile symlinks every skill under skills/ and external/ into both Claude Code (~/.claude/skills/) and Codex (~/.codex/skills/), so edits in this repo take effect immediately without re-publishing.

just add      # symlink all skills (skills/ + external/) into ~/.claude + ~/.codex
just remove   # remove only the symlinks that point back into this repo
just status   # show install status for each skill in both destinations
just vendor   # pull third-party skills declared in external.yml into external/
just          # list available recipes

add is idempotent and never clobbers: an existing real directory or a symlink from another source is left untouched and reported as skipped. remove only removes symlinks that resolve to this repo. After adding a new skill folder, just re-run just add.

External (third-party) skills

skills/ holds the skills authored here (and published via npx skills add). Third-party skills from other repos are not copied in — they are vendored separately so this repo stays purely self-written and free of foreign licenses:

1. Declare sources in external.yml — a repo, a ref (branch/tag/commit), and the sub-paths to pull. Each dir's basename, prefixed with 3rd-, becomes the skill name (e.g. dashboarding → 3rd-dashboarding).
2. just vendor shallow/sparse-clones each source, copies the named skill dirs into external/ (git-ignored) under their 3rd--prefixed names, rewrites each SKILL.md frontmatter name to match, and records the exact upstream commit SHA in external.lock.
3. just add symlinks them alongside the self-written skills.

The 3rd- prefix makes vendored skills easy to spot and invoke apart from the self-written ones in skills/. Only external.yml + external.lock are committed; the vendored code is not. Re-run just vendor any time to refresh (or after pinning a ref). A name that would collide with a self-written skills/<name> is skipped; entries removed from external.yml are pruned from external/ on the next just vendor.

Repository Structure

Justfile          # add / remove / status / vendor recipes
external.yml      # third-party skill sources (repo + ref + sub-paths)
external.lock     # resolved upstream commit SHAs (auto-generated)
scripts/
  vendor.sh       # pulls external.yml sources into external/
skills/           # self-written skills (published)
  fable-5-best-practice/
    SKILL.md
    references/
      evidence-notes.md
      prompt-patterns.md
  gpt-5-6-best-practice/
    SKILL.md
    references/
      evidence-notes.md
      prompt-patterns.md
  english-swe-daily/
    SKILL.md
    references/
      expressions-bank.md
  pi-setup/
    SKILL.md
    references/
      config-templates.md
      troubleshooting.md
  youtube-toolkit/
    SKILL.md
    scripts/
      install-tools.sh
      burn-subs.sh
    references/
      installation-and-recipes.md
      translate-and-burn.md
external/          # vendored third-party skills (git-ignored; just vendor)
  3rd-dashboarding/
  3rd-alerting-irm/
  3rd-grafana-oss/
  3rd-transitions-dev/

License

Add a license if you plan to distribute this publicly.