Skip to content

ztnel/agents

v0.2.0

Personal skills and custom agents for GitHub Copilot CLI.

GitHub

Agents

CI Latest release

GitHub Copilot CLI plugin for personal agent infrastructure.

Standard

This repository is an Agent Plugins 1.0.0 package. The canonical schema identifier in plugin.json pins the package format to exactly 1.0.0.

  • plugin.json is the Copilot plugin manifest.
  • mcp.json configures the official GitHub MCP endpoint for the repos and issues toolsets.
  • skills/ contains Agent Skills discovered as immediate child directories with SKILL.md.
  • com.github.copilot/ contains Copilot CLI custom agents exposed through the manifest extension namespace.

This repository supports GitHub Copilot CLI only. Compatibility with other clients is not tested or maintained.

CI

/.github/workflows/ci.yml runs two jobs on push to main and on pull_request:

  • regression compiles the repo, runs every Python test_*.py, the tuicr shell tests, skill linting, manifest checks, and git diff --check.
  • smoke installs Copilot CLI on Node 22, installs this workspace as a plugin, checks the declared plugin/skill/MCP inventory, and exercises each custom agent with a live noninteractive session when auth is available.

Set repository secret COPILOT_GITHUB_TOKEN to a fine-grained PAT with Copilot Requests permission. Forked pull requests skip the live-agent step and still run discovery.

Install

The commands below assume the repository has been published as ztnel/agents. Replace <version> with a release tag such as v0.2.0.

Copilot CLI can install the repository as a plugin:

copilot plugin install ztnel/agents

The installer does not expose a tag option. To load an exact release without installing it globally, check out the tag and pass the plugin root:

git clone --branch <version> --depth 1 https://github.com/ztnel/agents.git
copilot --plugin-dir ./agents

Copilot loads the skills, the custom agent under com.github.copilot/, and the root GitHub MCP configuration.

Design criteria

Use Agent Plugins 1.0.0 for the package shape and Copilot's reverse-domain extension namespace for Copilot CLI custom agents. Optimize all documented installation and runtime behavior for Copilot CLI rather than preserving cross-client compatibility.