XzhLoongSkills — Agent Guidelines

What this is

A monorepo of OpenCode/Codex AI agent skills organized into category directories under skills/. Each skill is a subdirectory with a SKILL.md (YAML frontmatter: name, description) and optional scripts/, references/, assets/.

No build system, no tests, no CI. The only package.json is in skills/academic/research-skills/paper-slide-deck/scripts/ (Node deps for PDF/slide generation). No Python package manager config exists.

Repo structure

skills/
  essential/          (通用必装 — 15 skills)
  code-dev/           (代码开发 — 14 skills)
  data-science/       (数据科学与机器学习 — 11 skills)
  academic/           (学术研究 — 6 + research-skills 子合集)
    research-skills/  (3 单智能体 + 5 多智能体调研系统)
  office/             (文档办公 — 7 skills)
  obsidian/           (Obsidian & 知识管理 — 5 obsidian-sub + 1 wiki)
  agency-agents/      (第三方 Agent 合集 — 来自 msitarzewski/agency-agents，17 领域 239 agents)

skills/essential/ (15): brainstorming, dispatching-parallel-agents, executing-plans, finishing-a-development-branch, handoff-doc, handoff-receive, handoff-review, karpathy-guidelines, planning-with-files, subagent-driven-development, systematic-debugging, using-superpowers, verification-before-completion, writing-plans, writing-skills
skills/code-dev/ (14): code-reviewer, code-simplifier, ponytail, ponytail-audit, ponytail-debt, ponytail-gain, ponytail-help, ponytail-review, ralph-loop, receiving-code-review, requesting-code-review, test-driven-development, using-git-worktrees, ui-ux-pro-max
skills/data-science/ (11): dask, exploratory-data-analysis, matplotlib, optimize-for-gpu, polars, pydicom, scikit-learn, seaborn, statistical-analysis, transformers, vaex
skills/academic/ (6 + research-skills/): citation-management, paper-lookup, parallel-web, pyzotero, research-lookup, scientific-writing, research-skills/
skills/office/ (7): docx, humanizer-zh, markdown-mermaid-writing, markitdown, pdf, pptx, xlsx
skills/obsidian/ (2 entries): obsidian-skills/ (5 sub-skills), xzh-obsidian-llm-wiki
skills/agency-agents/ (第三方 Agent 合集 — 17 领域 239 agents): 来自 msitarzewski/agency-agents，含 academic, design, engineering, finance, game-development, gis, healthcare, marketing, paid-media, product, project-management, sales, security, spatial-computing, specialized, strategy, support, testing
skills/agency-agents/ uses agency-agents native format (engineering/*.md, scripts/convert.sh), not SKILL.md. Do not validate or modify its contents against this repo's conventions.

Key conventions

Every skill must have a SKILL.md with frontmatter (name, description).
Use <HARD-GATE> markers in SKILL.md for non-negotiable workflow gates.
Skill descriptions should be detailed enough for the agent routing system to match correctly.
The name in frontmatter must match the leaf directory name (e.g., name: brainstorming, not essential/brainstorming).
scripts/ can contain Python, TypeScript, JS, or shell files; no CI enforces this.
No formatter, linter, or typechecker config exists at root level.

Adding a new skill

Create skills/<category>/<name>/SKILL.md with frontmatter (name, description).
Choose the right category (essential/, code-dev/, data-science/, academic/, office/, or obsidian/).
Add an entry to README.md:
- In the category table (under ## 技能分类)
- In the full alphabetical table (under ## 全部技能)
If the skill belongs to research-skills/ or obsidian-skills/, place it inside the respective sub-collection.

Removing a skill

Delete skills/<category>/<name>/.
Remove its entries from both tables in README.md.

After adding or removing a skill

The README.md has two tables that must stay in sync with skills/:

分类表 (## 技能分类) — one table per category, with an install command block above
全表 (## 全部技能) — single alphabetical list of all skills

Rule: After any add/remove, regenerate both tables to match the actual directory structure. Do not leave stale entries.

Git repos

GitHub: kekezack/XzhLoongSkills
Gogs (internal China mirror): gogs.1808366.xyz/kekezack/XzhLoongSkills.git
Branches: default master

Gotchas

skills/academic/research-skills/ has its own .gitignore (separate from root) that also ignores tmpclaude-* temp files.
The multi-agent survey system under research-skills/skills/ uses Chinese agent role names and config files with Chinese filenames.
paper-slide-deck requires npm install in its scripts/ directory before using TypeScript tools.
skills/office/humanizer-zh/CLAUDE.md declares a repo convention: use 「」 corner brackets as the quote style (with nested 『』), overriding default "" in this repository's docs.

AGENTS.md 4.9 KB Histórico Em bruto