agntc

Agent skills and knowledge installer for AI coding agents

A CLI that installs AI skills, agents, and hooks from git repos into projects, with multi-agent support and manifest-based tracking.

Install · Quick Start · Commands · Plugin Types · Why agntc?

agntc is a standalone CLI for installing shareable AI capabilities (skills, agents, hooks) from git repositories into any project. It works with multiple AI coding agents through a driver architecture — same source repo, different target directories per agent.

Everything is tracked in a manifest file, so you can update, remove, and list installed plugins without manual bookkeeping.

Why agntc?

Skills and agents are scattered across repos with no standard installation method. Current approaches have problems:

• Manual copy — tedious, no version tracking, easy to forget what came from where
• npm postinstall — tied to Node.js projects, couples plugin lifecycle to package manager
• git submodules — heavyweight, nested repo complexity, merge conflicts
• Vercel skills — skills only, no agents or hooks, telemetry

agntc sits in between: simple add command, manifest tracking, multi-agent routing, and support for all asset types.

Key differences

| | agntc | Vercel skills | Manual | npm postinstall | |---|---|---|---|---| | Skills | Yes | Yes | Yes | Yes | | Agents | Yes | No | Yes | Yes | | Hooks | Yes | No | Yes | Yes | | Multi-asset plugins | Yes | No | No | No | | Collections | Yes | No | No | No | | Version tracking | Manifest | Manifest | None | package.json | | File-level tracking | Yes | No | No | No | | Update command | Yes | Yes | No | Rebuild | | Non-Node projects | Yes | Yes | Yes | No | | Telemetry | No | Yes | No | No |

Install

Run directly with npx (recommended)

npx agntc <command>

Or install globally

npm install -g agntc

Quick Start

npx agntc init                        # scaffold a new plugin
npx agntc add owner/repo              # install from GitHub
npx agntc add owner/[email protected]         # specific version
npx agntc list                        # see installed + update status
npx agntc update                      # update all
npx agntc remove owner/repo           # remove plugin

Commands

init

Scaffold a new agntc plugin for authoring. Interactive type and agent selection.

npx agntc init

| Type | Scaffolded Structure | |---|---| | Skill | agntc.json, SKILL.md | | Plugin | agntc.json, skills/my-skill/SKILL.md, agents/, hooks/ | | Collection | my-plugin/ subdirectory with full plugin structure |

If agntc.json already exists, offers to reconfigure (overwrites config) or cancel.

add

Install plugins from git repos or local paths. Interactive agent and plugin selection.

npx agntc add <source>

| Source Format | Example | Notes | |---|---|---| | GitHub shorthand | owner/repo, owner/[email protected] | Primary format | | HTTPS URL | https://github.com/owner/repo | Any git host | | SSH URL | [email protected]:owner/repo.git | For SSH auth | | Local path | ./my-plugin, ~/dev/plugin | Local development | | Direct path | https://github.com/owner/repo/tree/main/plugin-name | Collection shortcut |

npx agntc add leeovery/claude-technical-workflows
npx agntc add leeovery/[email protected]
npx agntc add ./local-plugin
npx agntc add https://gitlab.com/org/repo

The tool detects plugin type automatically, shows agent multiselect (pre-selecting detected agents), checks for conflicts, and copies assets to agent-specific directories.

remove

Remove installed plugins and their files.

npx agntc remove [key]

| Mode | Command | Behaviour | |---|---|---| | Interactive | npx agntc remove | Pick from installed plugins | | Standalone | npx agntc remove owner/repo | Remove the plugin | | Collection (all) | npx agntc remove owner/repo | Remove all from collection | | Collection (one) | npx agntc remove owner/repo/name | Remove specific plugin |

npx agntc remove                           # interactive picker
npx agntc remove leeovery/claude-workflows
npx agntc remove leeovery/agent-skills/go

Always confirms before deleting files.

update

Check remote state and re-install plugins when newer versions exist.

npx agntc update [key]

| Mode | Command | Behaviour | |---|---|---| | Update all | npx agntc update | Update all installed | | Specific plugin | npx agntc update owner/repo | Update one (or all from collection) | | Collection plugin | npx agntc update owner/repo/name | Update specific |

npx agntc update                           # update all
npx agntc update leeovery/claude-workflows

Uses nuke-and-reinstall: deletes existing files, re-clones at same ref, re-copies for same agents. Tag-pinned plugins show available newer tags but don't auto-upgrade.

list

Interactive management dashboard with update status and inline actions.

npx agntc list

Shows all installed plugins with status indicators:

  leeovery/[email protected]    ✓ Up to date
  leeovery/agent-skills/go                      ↑ Update available
  leeovery/agent-skills/[email protected]             ⚑ Newer tags available
  leeovery/other-plugin                         ✗ Check failed

  Done

Select a plugin for detail view with actions: Update, Remove, Change version, Back.

Plugin Types

agntc detects plugin type from directory structure, not configuration fields.

Bare Skill

Single skill with SKILL.md at root:

my-skill/
  agntc.json          ← {"agents": ["claude"]}
  SKILL.md
  references/
    cheatsheet.md

Multi-Asset Plugin

Multiple asset types in recognized directories:

my-plugin/
  agntc.json          ← {"agents": ["claude"]}
  skills/
    planning/SKILL.md
    review/SKILL.md
  agents/
    executor.md
  hooks/
    pre-commit.sh

Collection

Multiple installable units in one repo (no root agntc.json):

my-collection/
  README.md
  go/
    agntc.json        ← {"agents": ["claude", "codex"]}
    SKILL.md
  python/
    agntc.json        ← {"agents": ["claude"]}
    SKILL.md
  complex-tool/
    agntc.json
    skills/
    agents/

Installing from a collection presents a multiselect of available plugins.

Plugin Configuration

Every installable unit requires an agntc.json at its root:

{
  "agents": ["claude", "codex"]
}

| Field | Type | Required | Description | |---|---|---|---| | agents | string[] | Yes | Agent identifiers this plugin supports |

Valid agents: claude, codex. Unknown values are warned but ignored.

Supported Agents

| Agent | Skills | Agents | Hooks | |---|---|---|---| | Claude | .claude/skills/ | .claude/agents/ | .claude/hooks/ | | Codex | .agents/skills/ | — | — |

Adding new agents is config-only — implement a driver with detection and routing.

Manifest

Tracks installations at .agntc/manifest.json:

{
  "leeovery/claude-technical-workflows": {
    "ref": "v2.1.6",
    "commit": "abc123f",
    "installedAt": "2026-02-09T14:30:00Z",
    "agents": ["claude"],
    "files": [
      ".claude/skills/technical-planning/",
      ".claude/agents/task-executor.md"
    ]
  }
}

The files array enables clean removal and nuke-and-reinstall updates.

License

MIT