Developer Agent Skills 🤖⚡

A production-ready collection of essential AI Agent Skills for software developers and web engineering workflows, designed for dual consumption:

1. As an AI Skills repository using npx skills add AdnanIqbalKhan/developer-agent-skills (Claude Code, Cursor, Antigravity, GitHub Copilot, Codex, etc.).
2. As an NPM package & CLI via npm install developer-agent-skills or npx developer-agent-skills.

⚡ Option 1: Install via AI Skills CLI (npx skills add)

To install skills directly into your project's AI agent environment using the standard skills CLI:

# Add all skills from this repository to your project
npx skills add AdnanIqbalKhan/developer-agent-skills

# Add a specific skill from this repository
npx skills add AdnanIqbalKhan/developer-agent-skills/code-review
npx skills add AdnanIqbalKhan/developer-agent-skills/figma
npx skills add AdnanIqbalKhan/developer-agent-skills/git-branch-report
npx skills add AdnanIqbalKhan/developer-agent-skills/project-docs-sync
npx skills add AdnanIqbalKhan/developer-agent-skills/ui-visual-feedback-loop

📦 Option 2: Install via NPM Package & CLI (npx developer-agent-skills)

Via npx (No installation needed):

# List all bundled skills
npx developer-agent-skills list

# Install skills into default project folder (.agents/skills)
npx developer-agent-skills install

# Install skills for specific agent targets
npx developer-agent-skills install --agent claude      # installs into .claude/skills
npx developer-agent-skills install --agent cursor      # installs into .cursor/skills
npx developer-agent-skills install --agent codex       # installs into .codex/skills
npx developer-agent-skills install --agent antigravity # installs into .gemini/skills

# Install specific skills only
npx developer-agent-skills install --skills code-review,git-branch-report

Binary aliases available: npx developer-agent-skills, npx developer-skills, npx agent-skills, npx skills-pack.

Via NPM Dependency:

npm install developer-agent-skills

const { getSkills, getSkillPath, installSkills } = require('developer-agent-skills');

// Programmatically discover or copy skills
const skills = getSkills();
installSkills({ targetDir: './.agents/skills' });

🛠 Included Skills Catalog

| Skill Name | Description | Location | | :--- | :--- | :--- | | code-review | Audits code changes from Git ranges or ticket branches and produces priority-sorted review reports. | skills/code-review/SKILL.md | | figma | Inspects Figma URLs directly in Chrome DevTools MCP, extracting layout/tokens without API quota limits. | skills/figma/SKILL.md | | git-branch-report | Generates detailed Markdown diff reports for any Git branch compared with a base branch. | skills/git-branch-report/SKILL.md | | project-docs-sync | Audits and synchronizes whole-project documentation with the live codebase. | skills/project-docs-sync/SKILL.md | | ui-visual-feedback-loop | Unified visual verification loop using Chrome DevTools MCP or automated Playwright screenshot diffing. | skills/ui-visual-feedback-loop/SKILL.md |

📂 Repository Structure

developer-agent-skills/
├── bin/
│   └── cli.js                      # Executable CLI tool for npx developer-agent-skills
├── skills/                          # Root skills directory for npx skills add
│   ├── code-review/                # Skill folder
│   │   ├── SKILL.md                # Standard YAML frontmatter + instructions
│   │   ├── references/
│   │   └── scripts/
│   ├── figma/
│   │   ├── SKILL.md
│   │   └── references/
│   ├── git-branch-report/
│   │   ├── SKILL.md
│   │   └── scripts/
│   ├── project-docs-sync/
│   │   ├── SKILL.md
│   │   └── scripts/
│   └── ui-visual-feedback-loop/
│       ├── SKILL.md
│       ├── references/
│       └── scripts/
├── index.js                         # Dynamic Node.js module API
├── package.json                     # NPM manifest & bin declarations
├── LICENSE                          # MIT License
└── README.md                        # Documentation

🚢 Publishing to NPM

# Verify package tarball
npm pack --dry-run

# Test publish payload
npm publish --dry-run

# Publish to NPM registry
npm publish --access public

📄 License

MIT © Developer Agent Skills Contributors