🧰 Agent Skills

Roast your GitHub with real data. Strip AI slop from your writing. Turn your git history into a documentary. Plus 52 more skills for developers and marketers.

Works with Claude Code · Cline · Cursor · Codex · any agent that reads SKILL.md

🌐 Website · Start here · Install · Packs · Social media · Marketing skills · Developer skills · What is a skill? · Awesome list

⭐ Start with these three

Each one runs a real script first, so the agent works from facts about your profile, text or repo instead of guessing.

🔥 roast-my-github

Pulls your public GitHub stats, roasts the habits (never the person), then gives you a scorecard and a five-step glow-up plan.
Try: "Roast my GitHub: your-username", or roast yourself in the browser with nothing to install.

🧹 ai-slop-detector

Scores text for AI-sounding phrases and patterns, shows where they are, and rewrites them to sound human while keeping your voice.
Try: "De-slop this blog post", or add the AI Slop Detector Action to flag AI-sounding docs and PR descriptions in CI.

⏳ codebase-time-machine

Reads your git history and tells the story of the repo as a documentary: its eras, cast, plot twists and cursed files.
Try: "Tell me the story of this codebase"

⚡ Install in 10 seconds

Option 1: Claude Code plugin (recommended)

/plugin install all-skills --marketplace milad-ahmd/agent-skills

Or install just one pack:

/plugin install creator-pack --marketplace milad-ahmd/agent-skills
/plugin install marketer-pack --marketplace milad-ahmd/agent-skills
/plugin install indie-hacker-pack --marketplace milad-ahmd/agent-skills
/plugin install local-business-pack --marketplace milad-ahmd/agent-skills
/plugin install startup-cto-pack --marketplace milad-ahmd/agent-skills
/plugin install developer-pack --marketplace milad-ahmd/agent-skills
/plugin install skill-builder-pack --marketplace milad-ahmd/agent-skills
/plugin install fun-pack --marketplace milad-ahmd/agent-skills

On older Claude Code versions, run /plugin marketplace add milad-ahmd/agent-skills first.

Option 2: npx skills (Cursor, Codex, Cline, Windsurf, Copilot and 75+ agents)

npx skills add milad-ahmd/agent-skills                          # pick skills interactively
npx skills add milad-ahmd/agent-skills --skill roast-my-github  # one skill

Option 3: shell installer

# all 55 skills
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash

# or a role-based pack
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash -s -- --pack creator

# or only the ones you want
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash -s -- pr-reviewer-pro env-secrets-guard

# project-local install (commit it so your whole team gets the skills)
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | SKILLS_DIR=.claude/skills bash

Then just talk to your agent normally. It picks the right skill automatically.

🎒 Packs: install by who you are

Run install.sh --list to see every skill and pack.

🎬 More demos (real output, not mockups)

🔐 env-secrets-guard	🩺 skills-doctor

📚 All 55 skills

⚙️ = ships a script that collects real data (git history, API results, files) before the agent writes anything.

🎉 Fun & Viral

🦸 Agent Superpowers

🛠️ Ops & Growth

🤖 Social Media Manager

One skill runs your whole social presence. It picks the platforms, sets KPIs and plans the week, then loads a detailed guide for each platform only when the task needs it, and hands Instagram, TikTok and YouTube work to their own skills.

📣 Marketing & Content Skills

Your AI agent can also act as a social media manager, content strategist and growth marketer.

💻 Developer Skills

🔀 Git & Workflow

🧪 Testing & Quality

🎨 Frontend

🧙 Refactoring

🔐 Security & Maintenance

🐳 DevOps & Backend

📚 Documentation

🚀 Growth

🤔 What is a skill?

A skill is a folder with a SKILL.md file: YAML frontmatter (name, description) followed by instructions, plus optional scripts. Your agent reads the description and loads the full instructions only when the task matches, so your context stays clean and the agent follows a proven workflow instead of improvising.

~/.claude/skills/
└── pr-reviewer-pro/
    ├── SKILL.md
    └── scripts/collect_diff.sh

Agent without native skill support? Paste any SKILL.md into your rules file (.clinerules, .cursor/rules, AGENTS.md, CLAUDE.md).

🧪 How the skills are tested

• Linted on every push with skills-doctor: frontmatter, trigger language, overlapping descriptions, missing scripts, leaked secrets. Lint your own skills in CI with the Skills Doctor Action.
• Trigger evals in evals/: every skill has prompts that should load it and prompts that belong to a neighbor. CI runs a free offline check on every push; python3 scripts/run_trigger_evals.py --live runs them against Claude Code itself.
• Unit tests for every skill script, run in CI.

🧠 Design principles

Every skill in this collection:

• ✅ Investigates before acting. It reads your repo and follows your conventions.
• ✅ Never invents facts. It cites evidence and marks unknowns as TODOs.
• ✅ Asks before anything destructive, such as pushing, force-pushing, deleting or posting.
• ✅ Produces a clear, structured output you can act on immediately.

🗺️ Roadmap

All 55 skills have shipped (changelog). Next up is your idea:

👉 Request a skill. Popular requests get built first.

💬 Questions, show-and-tell and ideas go in Discussions.

🤝 Contributing

Ideas, bug reports and new skills are welcome, and all of them belong in this repo: every skill lives in skills/<name>/, and the per-skill repos are read-only mirrors. CONTRIBUTING.md explains how to add or change a skill and run the checks. You can also browse community skills in awesome-agent-skills.

📄 License

MIT © Milad Ahmadi