laguagu

Agents Best Practices — AI skill for Claude Code

AI community

.agents-first best practices for AI agent skills — templates, guides, and auditing tools for Claude Code, Codex, Gemini CLI.

How to install Agents Best Practices

This entry records only its repository, not the path inside it, so there is no exact command to give. Open laguagu/agents-best-practices and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agents Best Practices does

.agents-first best practices for AI agent skills — templates, guides, and auditing tools for Claude Code, Codex, Gemini CLI.

Alternatives in AI

  • System Prompts Leaks — Extracted system prompts from ChatGPT (GPT-5.4, GPT-5.3, Codex), Claude (Opus 4.6, Sonnet 4.6, Claude Code), G 38.6k ★
  • AIHawk — Open-source AI browser agent: describe any task in plain language and it autonomously browses, clicks, types a 30.3k ★
  • CLI 代理 API — English 中文 一个为 CLI 提供 OpenAI/Gemini/Claude/Codex 兼容 API 接口的代理服务器 19k ★

README

Agent Skills Best Practices 🤖

Vendor-neutral best practices for the `.agents/skills/` ecosystem — governance and discovery tools for AI agent skills.

What is `.agents/skills/`? 📂

A directory convention where AI agent skills live as self-contained packages.

.agents/skills/my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
└── references/       # Optional: supplementary docs (opt-in, not default)

Supported by **Claude Code**, **OpenAI Codex**, **Gemini CLI**, **VS Code Copilot**, **Cursor**, and **JetBrains**.

Skills in This Repo 🛠️

This repo ships **governance** tooling + **discovery** tooling:

Skill Purpose
🧲 skill-finder Finds 1184+ existing official skills from 40+ teams before creating new ones
✨ skill-creator Creates new skills through a draft-test-iterate loop
🔍 improving-skills Audits skills, AGENTS.md, and CLAUDE.md against the agentskills.io spec

**Workflow**: `skill-finder` (check first) → `skill-creator` (if nothing fits) → `improving-skills` (audit the result)

Installing Skills 📥

Drop a skill directory at one of these paths. Agents discover it automatically.

Scope Path Platforms
Repo (team-wide, committed) .agents/skills// Claude Code, Codex, Gemini CLI
User (global, vendor-neutral) ~/.agents/skills// All agentskills.io-compatible tools
User (per-platform) ~/.claude/skills/, ~/.gemini/skills/ Platform-specific alternatives

Try this repo's skills 🚀

git clone https://github.com/laguagu/agents-best-practices.git
cp -r agents-best-practices/.agents/skills/skill-finder ~/.agents/skills/
cp -r agents-best-practices/.agents/skills/skill-creator ~/.agents/skills/
cp -r agents-best-practices/.agents/skills/impr