跳轉到

Agent Skills

Terminology rule (zh-TW pages)

技術名詞首次出現以「中文 (English original)」格式呈現，例：依賴注入 (dependency injection)。不自創翻譯——若無公認譯名直接保留英文 （如 embedding、tokenizer）。代碼、API 名、CLI flag、套件名、檔名一律不翻。

個人收藏的 agent skills —— 包含自製的 skill 與從 upstream repo 精選 (cherry-picked) 過來的 skill —— 可作為單一套件 (package) 安裝。

安裝 (Install)

# Install all skills bundled in this repo into your project's
# .agents/skills/ directory.
npx skills@latest add daviddwlee84/agent-skills/skills

Note The trailing /skills matters. Without it, npx skills will look in .agents/skills/ of the upstream repo, which contains a different layout. The skills/ suffix points the installer at the skills/local/ and skills/vendor/ trees.

This is the recommended cross-agent install path. Project installs place the canonical skill content under .agents/skills/, which Codex reads directly; Claude Code receives its corresponding .claude/skills/ links.

Heads-up — upstream picker bug. npx skills' interactive multiselect glitches once the skill list is long enough to scroll: options render duplicated and the selection state gets corrupted (vercel-labs/skills#969). This repo ships enough skills to trigger it. Until it's fixed upstream, skip the picker:

# Install everything, non-interactively (no picker)
npx skills@latest add daviddwlee84/agent-skills/skills --yes

# List names from a disposable directory. In an existing agent-managed
# project, skills@1.5.23 may reconcile .agents/skills even with --list.
scratch="$(mktemp -d)"
(cd "$scratch" && npx skills@latest add daviddwlee84/agent-skills/skills --list)
rm -rf "$scratch"

# Install one skill by name.
npx skills@latest add daviddwlee84/agent-skills/skills --skill clash-proxy-api

Optional: native Claude Code and Codex marketplaces

A local checkout can expose the same category catalog through either native plugin CLI:

git clone https://github.com/daviddwlee84/agent-skills.git

# Claude Code
claude plugin marketplace add ./agent-skills/skills
claude plugin install version-control@daviddwlee84-skills

# Codex (verified with 0.147.0)
codex plugin marketplace add ./agent-skills/skills
codex plugin add version-control@daviddwlee84-skills

Both native routes install a whole category plugin (version-control in this example), not an arbitrary single skill. Codex reads the existing Claude-format marketplace and generates its .codex-plugin/plugin.json adapter inside the plugin cache; this repository does not need to maintain that second manifest. Keep using npx skills when you want one skill or a cross-agent installation.

Pass the checkout's skills/ directory, not the repository root: the catalog intentionally lives under skills/.claude-plugin/ for the npx subpath above, and both native CLIs require a supported manifest at the marketplace source root.

內容概覽

skills/ 底下有三種 skill：

這個 repo 同時也是 project-knowledge-harness skill 套用在 自己身上的活範例：TODO.md、 backlog/、 pitfalls/ 位於 repo 根目錄，搭配 scripts/ 包裝 validator / promoter / inbox 工具組。

接下來去哪？

你的目的 該讀的頁面
安裝並試用這些 skill Getting Started
了解命名 / 佈局規則 Conventions
加入第三方 skill Adding vendor skills
自己寫一個 local skill Creating local skills
在你的 project 裡記錄 TODO 或 pitfall Project memory workflow
瀏覽現有的 skill Skills 總覽
瀏覽外部 skill、MCP、領域 (domain) hub Catalog
為自己的 project 建立 docs 站 (site) Downstream docs stack recipe

給 AI assistant 的入口

這個站點依照 llmstxt.org 規範提供 LLM-friendly endpoint：

  • llms.txt —— 預設語言頁面的精簡索引 (index)
  • llms-full.txt —— 預設語言頁面串接成的單一檔案
  • 任何頁面在 URL 後面加上 /index.md 就能取得 raw Markdown （例如 getting-started/index.md）。

如果你是讀這頁的 agent，建議用 llms-full.txt 一次拿到完整 context， 或是抓特定頁面的 */index.md 路徑。