Using Agent Skills
addyosmani/agent-skills
Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.
项目初始化工具。读取全局协议 ~/.claude/CLAUDE.md,分析项目实际情况,生成项目特定的 CLAUDE.md 和 docs/ 上下文。本技能应在用户说"初始化项目"、"项目设置"、"配置 Claude Code"、"新建项目配置"时使用,或在进入一个新项目需要快速配置时使用。不要用于:Skill 内容开发或验收(用 skill-lint)、单次 Skill 安装(用…
$ npx skills add cat-xierluo/legal-skills --skill project-init -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cat-xierluo/legal-skills project-init --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/project-init .claude/skills/project-init && rm -rf skills-srcUse ~/.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/
Install the "project-init" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-init into .claude/skills/project-init/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-init", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-initType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add cat-xierluo/legal-skills --skill project-init -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cat-xierluo/legal-skills project-init --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/project-init .agents/skills/project-init && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "project-init" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-init into .agents/skills/project-init/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-init", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cat-xierluo/legal-skills --skill project-init -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cat-xierluo/legal-skills project-init --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/project-init .cursor/skills/project-init && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "project-init" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-init into .cursor/skills/project-init/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-init", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/cat-xierluo/legal-skills.git --path skills/project-init--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add cat-xierluo/legal-skills --skill project-init -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cat-xierluo/legal-skills project-init --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/project-init .gemini/skills/project-init && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "project-init" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-init into .gemini/skills/project-init/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-init", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install cat-xierluo/legal-skills project-initInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add cat-xierluo/legal-skills --skill project-init -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/project-init .github/skills/project-init && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "project-init" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-init into .github/skills/project-init/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-init", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cat-xierluo/legal-skills --skill project-init -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cat-xierluo/legal-skills project-init --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cat-xierluo/legal-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/project-init .opencode/skills/project-init && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "project-init" agent skill from https://github.com/cat-xierluo/legal-skills/tree/main/skills/project-init into .opencode/skills/project-init/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "project-init", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
project-init项目初始化工具。读取全局协议 ~/.claude/CLAUDE.md,分析项目实际情况,生成项目特定的 CLAUDE.md 和 docs/ 上下文。本技能应在用户说"初始化项目"、"项目设置"、"配置 Claude Code"、"新建项目配置"时使用,或在进入一个新项目需要快速配置时使用。不要用于:Skill 内容开发或验收(用 skill-lint)、单次 Skill 安装(用…
Project Init is an agent skill from cat-xierluo/legal-skills. 项目初始化工具。读取全局协议 ~/.claude/CLAUDE.md,分析项目实际情况,生成项目特定的 CLAUDE.md 和 docs/ 上下文。本技能应在用户说"初始化项目"、"项目设置"、"配置 Claude Code"、"新建项目配置"时使用,或在进入一个新项目需要快速配置时使用。不要用于:Skill 内容开发或验收(用 skill-lint)、单次 Skill 安装(用 skill-manager)、代码生成。
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts and assets (for example `CHANGELOG.md`, `assets/claude-settings-template.json` and `config/profiles.example.yaml`).
It sits in Agent Workflows, covering Agent instruction files and Skill management. The licence is MIT.
12 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit c077fcc. It shows what the files ask for, not the result of running them.
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.
Ships 1 file in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
bashFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Project Init loads about 1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 259 words of instructions outside code blocks.
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.
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.
The full file from cat-xierluo/legal-skills at commit c077fcc, republished under its MIT licence (© cat-xierluo). 259 words, ~1,047 tokens.
.claude/skills/project-init/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.读取全局协议,分析项目,生成上下文。
读取 ~/.claude/CLAUDE.md(及其 @include 引用的文件),理解全局协作协议。这是生成项目上下文的基准——项目文档的格式和结构应对齐全局协议中的定义(如文档体系、SOP、DECISIONS 格式等)。
读取本 skill 目录下的 config/profiles.yaml,获取:
skill_sources: Skill 源仓库路径profiles: 各项目类型的检测规则和 Skill 列表scripts/init.sh detect <project_dir> 获取指示文件列表。detect 规则:any_of: 任一文件存在即匹配has_skill_md: 根目录或 skills/ 子目录下存在 SKILL.mdextensions: 指定扩展名文件数 >= min_countdir_patterns: 任一目录名存在即匹配default_profile。在生成任何文件之前,先分析项目实际情况:
package.json / pyproject.toml / Cargo.toml 等获取技术栈src/、app/、lib/ 等).claude/、CLAUDE.md、docs/ 等将这些信息汇总,作为后续生成上下文的素材。
向用户展示检测结果和生成计划,必须等待确认。若计划使用文件化任务源,同时说明:
Lite、Standard 或 Strict 配置及理由;mkdir -p .claude/skills/对 profile 中 skills 字段列出的每个 Skill,通过调用 skill-manager Skill 以符号链接方式安装到项目的 .claude/skills/ 目录。skill-manager 会自动处理路径解析、去重和版本追踪。
不是复制模板,而是基于全局协议 + 项目分析结果生成项目特定的 AGENTS.md。
参考 templates/agents-template.md 中各项目类型的结构模板和生成指南,结合 Step 4 的分析结果,生成包含真实项目信息的内容,写入 AGENTS.md。
templates/agents-template.md 包含所有项目类型的段落定义、结构模板和脱敏范例,无需参考其他外部文件。
CLAUDE.md 不重复写内容,仅写入:
@include ./AGENTS.md这样 Claude Code 和 Codex 共享同一份项目协议,只维护一个源文件。
已有 AGENTS.md 时展示 diff,让用户决定覆盖/合并/跳过。已有 CLAUDE.md 但内容不是纯 @include 时,同样展示 diff。
将 assets/claude-settings-template.json 原样复制为项目 .claude/settings.json。已有则跳过。
bash scripts/init.sh codex "<project_dir>"
bash scripts/init.sh agents "<project_dir>"创建 .codex/ 目录结构:
config.toml:从 assets/codex-config.toml 复制rules/default.rules:从 assets/codex-default.rules 复制skills:符号链接 → ../.claude/skills(与 .claude/skills/ 共享,不重复安装)创建 .agents/ 目录结构:
skills:符号链接 → ../.claude/skills,供遵循 .agents 目录约定的代理发现同一批 Skill两者已有则跳过。目录级软链确保各代理目录与 .claude/skills/ 共享同一 Skill 源:向 .claude/skills/ 安装或移除 Skill 时自动同步,不逐 skill 复制或双写链接。.codex/skills 软链确保 Codex 能直接访问 .claude/skills/ 中已安装的 Skill。
不是复制空模板,而是基于全局协议的文档体系定义 + 项目分析结果生成有实际内容的文档。
按需读取对应文档模板,结合项目选择的协作文档体系生成真实初始内容;不要复制空壳或保留占位符:
templates/roadmap-template.md,从 README、版本和当前实现提取愿景、状态与阶段规划templates/decision-log-template.md,记录真实存在的初始化决策和工作日志,不虚构备选方案templates/task-template.md,根据项目风险选择一个任务配置,生成真实队列与任务卡。不要逐字复制生成指南,也不要生成与所选配置无关的空章节。文件名和位置由项目上下文决定templates/architecture-template.md,从目录结构、入口和技术栈生成初始架构描述templates/design-template.md,结合实际设计系统和技术栈生成templates/changelog-template.md,使用明确版本号和日期生成初始化记录任务文件只作为当前任务入口:长期方向留在 ROADMAP,重要取舍留在 DECISIONS,用户可见历史留在 CHANGELOG。任务完成并同步相应文档后,从活跃区移除;不为任务文件创建快照、before 副本或专用历史归档。仅创建不存在的文件;已有任务文件时展示 diff,由用户决定合并或跳过,不直接覆盖。
将 assets/gitignore-template 原样复制为项目 .gitignore。已有则跳过。
bash scripts/init.sh scaffold "<project_dir>" "<skill_name>"创建 references/、scripts/、assets/、SKILL.md、LICENSE.txt。
编辑 config/profiles.yaml 自定义。
templates/:读取后结合项目事实选择、裁剪和填充;不得原样复制,也不得保留占位符。文件统一使用 *-template.md,避免与生成目标同名或命中常见 Git 忽略规则。assets/:不需要载入上下文,按步骤或脚本原样复制到目标位置;已有目标文件时遵循幂等规则。templates/,固定内容进入 assets/。符号链接相同目标 → 跳过;文件已存在 → 不覆盖。
© cat-xierluo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 16 other files (scripts, assets) in skills/project-init of cat-xierluo/legal-skills.
Open the folder on GitHubat commit c077fcc
Project Init 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Project Init this skillcat-xierluo/legal-skills | 713 | — | ~1k | Automated safety check: Pass | MIT | |
| Using Agent Skillsaddyosmani/agent-skills | 103k | 4 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~12k | Automated safety check: Pass | CC-BY-4.0 | |
| Rules Distillationaffaan-m/ECC | 275k | 2 repos | ~2.3k | Automated safety check: Pass | MIT | |
| Birdview Skills Compatibility AuditQiuner/birdview | 721 | — | ~794 | Automated safety check: Pass | MIT | |
| Context Routing Auditwithkynam/vibecode-pro-max-kit | 1.1k | — | ~1.2k | Automated safety check: Pass | MIT |
addyosmani/agent-skills
Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
affaan-m/ECC
Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.
Qiuner/birdview
Audits the AI skills installed for a project for duplicate names, broad triggers and conflicting instructions, without changing any of them.
withkynam/vibecode-pro-max-kit
Audits a project's context routing, skill discoverability and skill wiring by running a chain of validator scripts and fixing whatever they report.
mistralai/mistral-vibe
Reference for Mistral Vibe, the CLI agent it runs inside: config files, env vars, agents, skills, tools, hooks and MCP servers, so the agent can explain and troubleshoot its own setup.
cat-xierluo/legal-skills
Converts a lawyer's ordinary complaint or a described case into the Supreme People's Court's elements-style Word template, with layout checks on the result.
cat-xierluo/legal-skills
Analyzes raw lecture transcripts for verbal tics, pacing, time use and promise follow-through, with optional slide-by-slide comparison and cross-session tracking.
cat-xierluo/legal-skills
Detects and rewrites machine-sounding patterns in the body text of Chinese articles while keeping the author's facts, headings and legal terms intact.
cat-xierluo/legal-skills
Finds GitHub projects mentioned in articles or screenshots and stars them, tracks updates to your starred repos, and builds an HTML dashboard to browse them.
cat-xierluo/legal-skills
Sets up or incrementally updates AGENTS.md and CLAUDE.md for legal professionals, with a minimal safety baseline and a check that a new session loads and follows the rules.
cat-xierluo/legal-skills
Chinese-language skill that organizes a case file into a multi-role mock trial with judge, parties and clerk, producing a transcript, issue review and a to-strengthen list.
Categories
项目初始化工具。读取全局协议 ~/.claude/CLAUDE.md,分析项目实际情况,生成项目特定的 CLAUDE.md 和 docs/ 上下文。本技能应在用户说"初始化项目"、"项目设置"、"配置 Claude Code"、"新建项目配置"时使用,或在进入一个新项目需要快速配置时使用。不要用于:Skill 内容开发或验收(用 skill-lint)、单次 Skill 安装(用…. Project Init is an agent skill from cat-xierluo/legal-skills.
Project Init fits situations like: tasks that involve Agent instruction files; tasks that involve Skill management.
Run `npx skills add cat-xierluo/legal-skills --skill project-init -a claude-code`. Or copy the skill folder (skills/project-init in cat-xierluo/legal-skills) into .claude/skills/project-init in your project. Claude Code loads it when a task matches its description.
Run `npx skills add cat-xierluo/legal-skills --skill project-init -a codex`. Or copy the skill folder (skills/project-init in cat-xierluo/legal-skills) into .agents/skills/project-init in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cat-xierluo/legal-skills --skill project-init -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-init, .gemini/skills/project-init, .github/skills/project-init and .opencode/skills/project-init in your project.
Going by SKILL.md and its folder, Project Init needs a shell for the scripts in its folder and the command-line tools its instructions call (bash). Our summary lists: A Bash shell.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
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.
Project Init is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Project Init: Using Agent Skills (addyosmani/agent-skills, 103k stars), Task Observer (rebelytics/one-skill-to-rule-them-all, 3.2k stars), Rules Distillation (affaan-m/ECC, 275k stars) and Birdview Skills Compatibility Audit (Qiuner/birdview, 721 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
cat-xierluo (a GitHub user) maintains it in cat-xierluo/legal-skills, which has 713 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on October 7, 2026.
Source: cat-xierluo/legal-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.