Skip to content
v1.0.0MIT

Agent skills, custom agents, slash commands, and MCP servers for productive AI-assisted engineering workflows.

Agents Skills

An Agent Plugin that bundles portable skills, custom agents, slash commands, and MCP servers for GitHub Copilot, while also exposing the same skills as a global ~/.agents/skills directory usable by any AI tool that follows that convention.

Quick Start

Install globally with platform wiring prompts:

curl -fsSL https://raw.githubusercontent.com/anthuanvasquez/agents-skills/main/install.sh | bash

Install non-interactive and wire GitHub Copilot:

curl -fsSL https://raw.githubusercontent.com/anthuanvasquez/agents-skills/main/install.sh | bash -s -- --platforms copilot --non-interactive

Supported platform values:

  • none — only install skills to ~/.agents/skills.
  • copilot — also copy Copilot-specific assets to the standard user directories.

Default behavior installs skills/ into ~/.agents/skills.

Selecting copilot copies:

  • com.github.copilot/agents/* → ~/.copilot/agents/
  • com.github.copilot/commands/* → ~/.copilot/prompts/
  • com.github.copilot/instructions/* → ~/.copilot/instructions/

Copilot Agent Plugin

This repository is also a valid Agent Plugins 1.0 package. You can import it as a plugin in VS Code or the GitHub Copilot app without running the install script:

  1. Open the Command Palette and run Chat: Install Plugin From Source.
  2. Enter https://github.com/anthuanvasquez/agents-skills.

When imported as a plugin, Copilot discovers:

The global install script does not copy plugin.json or mcp.json into ~/.copilot/; those are only consumed when the repo is imported as a plugin.

Dev Container Feature

This repository ships a Dev Container Feature consumable from GHCR. The feature installs the skills globally and optionally wires GitHub Copilot.

Feature option:

  • platforms (string): none|copilot

Example:

{
	"features": {
		"ghcr.io/anthuanvasquez/agents-skills/skills:latest": {
			"platforms": "copilot"
		}
	}
}

An example consumer exists at .devcontainer/devcontainer.json.

Available Skills

SkillDescription
API Design PrinciplesREST and GraphQL best practices for maintainable APIs.
BrainstormingSocratic questioning protocol for complex requests and new features.
Changelog GeneratorAutomated customer-facing release notes from commit history.
Error Handling PatternsResilient error propagation and graceful degradation strategies.
Git CommitConventional commits with intelligent staging and message generation.
Improve Codebase ArchitectureScan a codebase for deepening opportunities and produce a visual HTML report.
Interface DesignExpert guidance for dashboards, admin panels, and interactive tools.
Perfect Code ReviewStructured pull request code review using the PERFECT framework.
Systematic DebuggingProfessional root-cause analysis and debugging protocol.
Test-Driven DevelopmentTest-first development guidance and patterns.

Test

docker build -t skills-test .
docker run -it -v $(pwd):/home/test/skills skills-test bash

# inside container
cd /home/test/skills
./install.sh --platforms copilot --non-interactive
./test.sh

# or explicit
./test.sh --platforms copilot

License

MIT