Agent Mag

The CLI for AI agent builders. Install skills, tools, local Ollama models, Codex pets, and first-party Agent Mag docs context.

Browse Skills | Browse Tools | Browse Models | Browse Codex Pets | Docs | Website

What It Does

agentmag is a single CLI that installs five types of things:

| Type | What It Is | What Gets Installed | |------|-----------|-------------------| | Skills | Config bundles for AI coding agents | manifest.json, prompt.md, tools.json, config.json | | Tools | Executable GitHub Actions and utilities | .github/workflows/*.yml workflow files | | Models | Local open models from Ollama | Runs ollama pull <model> and tracks installs | | Codex Pets | Local Codex desktop pet packs | ~/.codex/pets/<slug>/pet.json, metadata, README, and sprite sheet | | Docs | First-party Agent Mag documentation context | .agents/docs/agentmag/<slug>.md and .json |

Skills teach your agent new capabilities. Tools automate your dev workflow. Models give local runtimes a one-command install path. Codex pets personalize the local Codex desktop workspace. Docs give agents source-grounded Agent Mag context without installing a skill bundle.

Quick Start

# Install a skill (config bundle for your coding agent)
npx agentmag add skill web-browsing

# Install a tool (GitHub Action workflow)
npx agentmag add tool seo-geo-reviewer
npx agentmag add tool pr-security-auto-fix

# Pull a local Ollama model
npx agentmag add model qwen3.6

# Install a Codex pet
npx agentmag add codexpet spider noir

# Install docs context for an agent
npx agentmag add docs scrape
npx agentmag add docs index

# Install multiple skills at once
npx agentmag add skill code-execution terminal git-ops

# Search the registry
npx agentmag search "database"

# Search by category
npx agentmag search --category "Code & Compute"

# List installed skills
npx agentmag list

# Update installed skills
npx agentmag update

No global install needed. npx runs it directly.

Skills

Skills are config bundles that give AI coding agents new capabilities. They work with Claude Code, Cursor, Windsurf, Copilot, and other MCP-compatible agents.

Each skill installs 4 files:

.agentmag/skills/<skill-name>/
  manifest.json    # metadata, version, compatibility
  prompt.md        # system prompt for the agent
  tools.json       # tool definitions (MCP format)
  config.json      # configuration template

Available Skills (28+)

| Category | Skills | |----------|--------| | Code & Compute | code-execution, terminal, git-ops, code-review | | Web & Browsing | web-browsing, web-scraping, api-integration | | Data & Knowledge | database-query, file-management, knowledge-base | | Communication | email-assistant, slack-integration, notification-hub | | DevOps & Infra | docker-management, ci-cd-pipeline, cloud-deploy | | Specialized | image-analysis, pdf-processing, calendar-management |

Browse all at agentmag.dev/skills

Models

Models are local Ollama models. Agent Mag wraps the Ollama pull flow so builders can copy one command from the /models directory:

npx agentmag add model qwen3.6

Under the hood this runs:

ollama pull qwen3.6

After install, run the model normally:

ollama run qwen3.6

Browse local model entries at agentmag.dev/models.

Codex Pets

Codex pets are local desktop pet packs for Codex. Each pack installs a compact manifest, metadata, README, and sprite sheet into your Codex home directory:

npx agentmag add codexpet spider noir

This writes:

~/.codex/pets/noir-webling/
  pet.json
  metadata.json
  README.md
  spritesheet.webp

Add --force to overwrite an existing pet pack. Browse all pets at agentmag.dev/codex-pets.

Docs Context

Docs are first-party Agent Mag content/context. They are not skills, not executable tools, and not counted as skill installs.

npx agentmag add docs scrape

This writes:

.agents/docs/agentmag/scrape.md
.agents/docs/agentmag/scrape.json

Use index for the root docs page:

npx agentmag add docs index

Add --force to overwrite an existing docs context file.

Browse docs at docs.agentmag.dev.

Tools

Tools are executable automations installed as GitHub Action workflows. One command scaffolds everything.

SEO/GEO Auto-Fix Reviewer

AI-powered GitHub Action that reviews PRs for 90+ SEO and GEO issues --- and commits the fixes directly to your branch.

npx agentmag add tool seo-geo-reviewer

This creates .github/workflows/seo-geo-review.yml. Set your ANTHROPIC_API_KEY secret and push.

What it does:

• Scans PRs for metadata, schema, heading, alt text, anchor text, and citability issues
• Produces search-and-replace patches for every HIGH and MEDIUM finding
• Commits fixes directly to the PR branch via GitHub Git Data API
• Posts a branded comment with verdict, findings, and what was auto-fixed
• GPT-5.4 primary, Claude Opus 4.6 fallback

Source: Agent-mag/tools/seo-geo-reviewer

PR Security Auto-Fix

AI-powered GitHub Action that reviews pull requests for high-confidence security vulnerabilities --- and commits safe fixes directly to trusted PR branches.

npx agentmag add tool pr-security-auto-fix

This creates .github/workflows/pr-security-auto-fix.yml. Set your Azure OpenAI GPT-5.4 secrets or ANTHROPIC_API_KEY, then push.

What it does:

• Scans changed files for concrete exploit paths, not generic hardening noise
• Covers injection, auth bypass, data exposure, XSS, SSRF, unsafe config, and AI-agent tool risks
• Produces exact search-and-replace patches for safe HIGH and MEDIUM findings
• Commits fixes directly to trusted PR branches via GitHub Git Data API
• Posts a branded comment with verdict, exploit scenario, recommendation, and fix summary
• GPT-5.4 primary, Claude Opus 4.6 fallback

Source: Agent-mag/tools/pr-security-auto-fix

Browse all at agentmag.dev/tools

All Commands

| Command | Alias | Description | |---------|-------|-------------| | agentmag add skill <name> | install, i | Install a skill from the registry | | agentmag add tool <name> | | Install a tool (GitHub Action workflow) | | agentmag add model <name> | | Pull a local Ollama model | | agentmag add codexpet <name> | | Install a Codex pet to ~/.codex/pets | | agentmag add docs <slug> | | Install first-party docs context | | agentmag remove <name> | rm, uninstall | Uninstall a skill | | agentmag list | ls | Show installed skills | | agentmag search [query] | find | Search the registry | | agentmag update [name] | upgrade | Update installed skills | | agentmag help | --help, -h | Show help |

Options

| Flag | Description | |------|-------------| | --force, -f | Force reinstall even if already installed | | --category, -c | Filter search by category | | --help, -h | Show help |

How It Works

npx agentmag add skill web-browsing
    │
    ├─ Fetches skill from Agent Mag API
    ├─ Detects your agent (Claude Code, Cursor, etc.)
    ├─ Writes config files to .agentmag/skills/
    └─ Tracks install for download counts

npx agentmag add model qwen3.6
    │
    ├─ Checks that Ollama is installed
    ├─ Runs ollama pull qwen3.6
    └─ Tracks install for model adoption counts

npx agentmag add codexpet spider noir
    │
    ├─ Resolves the pet name from Agent Mag
    ├─ Downloads the sprite sheet
    ├─ Writes pet.json, metadata.json, README.md, and spritesheet.webp
    └─ Tracks install for pet adoption counts

npx agentmag add tool seo-geo-reviewer
    │
    ├─ Looks up tool in local registry
    ├─ Generates workflow YAML
    ├─ Writes to .github/workflows/
    └─ Shows required secrets

npx agentmag add docs scrape
    │
    ├─ Fetches docs context from Agent Mag
    ├─ Writes Markdown to .agents/docs/agentmag/scrape.md
    └─ Writes structured JSON to .agents/docs/agentmag/scrape.json

Requirements

• Node.js 18+
• No dependencies (zero-dep CLI)

Contributing

• Submit a skill: Open a PR at Agent-mag/skills
• Submit a tool: Open a PR at Agent-mag/tools
• Report issues: github.com/Agent-mag/agentmag/issues

License

MIT --- see LICENSE for details.

Built by Agent Mag - the magazine for AI agent builders.

Website | Skills | Models | Tools | Codex Pets | Docs | Newsletter | GitHub