Daraja Skills

Cross-agent Safaricom Daraja and M-Pesa integration skills for vibe coders.

Daraja Skills packages one source-grounded workflow for the coding agents developers actually use:

• Codex skill, plus optional Codex plugin marketplace packaging
• Cursor project rule
• Gemini CLI skill, plus optional Gemini extension packaging
• Antigravity workspace or global skill
• Claude Code project or personal skill
• optional generic AGENTS.md

The package is built for Daraja 3.0/V3 work, but it refuses to treat unverified scraped endpoint snippets as final contract truth.

Install

npx daraja-skills install

In a terminal, this opens a wizard that asks:

• which target(s) to install
• whether each target should be project-local or global
• which project root to use

For scripts and CI, pass --yes with explicit targets:

default targets: codex,cursor,gemini,antigravity,claude

Install a specific project target:

npx daraja-skills install --target codex --scope project --yes
npx daraja-skills install --target cursor --scope project --yes
npx daraja-skills install --target gemini --scope project --yes
npx daraja-skills install --target antigravity --scope project --yes
npx daraja-skills install --target claude --scope project --yes
npx daraja-skills install --target agents --scope project --yes

Install a personal/global skill where the platform supports it:

npx daraja-skills install --target codex --scope global --yes
npx daraja-skills install --target gemini --scope global --yes
npx daraja-skills install --target antigravity --scope global --yes
npx daraja-skills install --target claude --scope global --yes

Install everything project-local, including generic AGENTS.md:

npx daraja-skills install --target all --scope project --yes

Use another project root or inspect the install plan:

npx daraja-skills install --project /path/to/app
npx daraja-skills where --target all --scope project

What Gets Installed

| Target | Project install | Global install | | --- | --- | --- | | Codex | .agents/skills/daraja-api | ~/.agents/skills/daraja-api | | Cursor | .cursor/rules/daraja-skills.mdc | not supported by Cursor as a filesystem install | | Gemini CLI | .gemini/skills/daraja-api | ~/.gemini/skills/daraja-api | | Gemini extension | not applicable | ~/.gemini/extensions/daraja-skills | | Antigravity | .agents/skills/daraja-api | ~/.gemini/antigravity/skills/daraja-api | | Claude Code | .claude/skills/daraja-api | ~/.claude/skills/daraja-api | | Codex plugin | plugins/daraja-skills plus .agents/plugins/marketplace.json | ~/.codex/plugins/daraja-skills plus ~/.agents/plugins/marketplace.json | | Generic agents | AGENTS.md | not applicable |

Project installs default to the nearest Git root, so running from packages/cli writes to the repository root rather than burying rules in a nested package.

Source Policy

The scraped files in /Users/mesh/Documents/skills are useful discovery material, but they are not enough to publish final Daraja 3.0 endpoint contracts.

Current verified state:

• Official Safaricom pages confirm Daraja 3.0 as the current platform target.
• The captured official pages did not expose endpoint-level contracts.
• Many scraped endpoint paths and request bodies look like legacy/common Daraja material, but they remain unverified for Daraja 3.0 until official V3 endpoint pages or discovery payloads are captured.

So the shipped skill focuses on safe implementation workflow:

• server-side credentials only
• local payment intent before network call
• callback/result/timeout handling
• raw callback persistence
• idempotency and reconciliation
• production HTTPS callback requirements
• stricter controls for B2C, B2B, reversals, account balance, and transaction status

Local Checks

node bin/daraja-skills.mjs verify
npm test
npm run build
npm run pack:check

Project Files

• skills/daraja-api: canonical skill source
• plugins/daraja-skills: Codex plugin package
• adapters/: platform-specific exports
• bin/daraja-skills.mjs: npm installer CLI
• index.html, styles.css, site.js: static landing site

Daraja Skills is not an official Safaricom product.