developersglobal/ai-agent-skills

---

🎯 What is this?

AI agents are only as good as the instructions they follow. AI Agent Skills is a curated, battle-tested library of skill files — structured markdown prompts — that transform AI coding agents (Claude, Gemini, Cursor, Copilot, etc.) into disciplined, production-ready engineers.

Unlike generic prompts, these skills encode actual workflows with steps, checkpoints, verification gates, and anti-pattern guards — the same discipline senior engineers bring to every production deployment.

THINK → PLAN → BUILD → TEST → REVIEW → HARDEN → SHIP
  ↓        ↓      ↓       ↓       ↓        ↓        ↓
Clarify  Break  Write  Verify  Quality  Security  Deploy
Goals    Down   Code   Output  Gates    Gates     Live

---

🏆 Why This Repo Goes Beyond the Rest

---

⚡ Quick Start

Step 1 — Clone the repo

git clone https://github.com/DevelopersGlobal/ai-agent-skills.git

Step 2 — Pick a skill and copy it into your agent

Claude / Cursor / Copilot / any agent: Copy the contents of any SKILL.md file into your agent’s system prompt, instructions file, or context window.

For Claude Code — add to your project’s CLAUDE.md:

cat skills/think-before-coding/SKILL.md >> CLAUDE.md

For Cursor — copy into .cursor/rules/:

cp skills/security-hardening/SKILL.md .cursor/rules/security-hardening.mdc

For Gemini CLI — add to your project’s GEMINI.md:

cat skills/goal-driven-execution/SKILL.md >> GEMINI.md

One-liner (any skill, any agent):

# View raw skill content, then paste into your agent
curl https://raw.githubusercontent.com/DevelopersGlobal/ai-agent-skills/main/skills/production-deployment/SKILL.md

Browse and copy skills visually → developersglobal.github.io/ai-agent-skills

---

📚 All 30 Skills

🧠 Think — Before You Code

📐 Plan — Break It Down

🏗️ Build — Write Production Code

✅ Test — Prove It Works

🔍 Review — Quality Gates

🔒 Harden — Security & Reliability

🚀 Ship — Deploy with Confidence

🌟 Everyday — Productivity Skills

---

🏛️ Skill Anatomy

Every skill follows the same battle-tested structure:

┌─────────────────────────────────────────────────────┐
│ SKILL.md                                            │
│                                                     │
│  ┌─ Frontmatter ────────────────────────────────┐  │
│  │  name:        kebab-case-name                │  │
│  │  description: One-line trigger description   │  │
│  │  applies-to:  [claude, gemini, cursor, ...]  │  │
│  │  category:    think|plan|build|test|...      │  │
│  └──────────────────────────────────────────────┘  │
│                                                     │
│  Overview      → What this skill accomplishes       │
│  When to Use   → Exact triggering conditions        │
│  Process       → Numbered, verifiable steps         │
│  Rationalizations → Common excuses + rebuttals      │
│  Red Flags     → Warning signs the skill is needed  │
│  Verification  → Non-negotiable evidence required   │
│  References    → Supporting checklists/docs         │
└─────────────────────────────────────────────────────┘

---

🤝 Contributing

We welcome contributions! The best skills are:

• Specific — Actionable steps, not vague principles
• Verifiable — Clear exit criteria with evidence
• Battle-tested — Based on real production experience
• Minimal — Only what the agent needs; no bloat

See CONTRIBUTING.md and docs/skill-anatomy.md.

---

🌐 GitHub Pages

The full skills library is browsable at developersglobal.github.io/ai-agent-skills with:

• 🔍 Full-text search across all skills
• 🏷️ Filter by category and agent type
• 📋 One-click copy for any skill
• 📱 Mobile-friendly responsive design

---

📊 Inspiration & Credits

This project builds on and extends the ideas from:

• addyosmani/agent-skills — Production engineering skills for AI agents
• forrestchang/andrej-karpathy-skills — Karpathy’s observations on LLM coding pitfalls
• DevelopersGlobal — Community-driven developer tools

---

📄 License

MIT — Use these skills in your projects, teams, and tools. Attribution appreciated but not required.

---