@silverassist/agents-toolkit

@silverassist/agents-toolkit

Reusable AI agent prompts for development workflows — supports GitHub Copilot, Claude Code, and Codex with multi-stack and multi-tracker filtering.

Features

• ✅ Complete Workflow Prompts: From ticket analysis to PR merge
• ✅ Multi-Agent Support: Works with GitHub Copilot, Claude Code, and Codex
• ✅ Multi-Stack Filtering: Install only React or WordPress content with --stack
• ✅ Multi-Tracker Support: Choose GitHub Issues or Jira workflows with --tracker
• ✅ Global Install: Install once for all projects with --global
• ✅ Modular Partials: Reusable prompt fragments
• ✅ Customizable: Easy to extend and modify
• ✅ PostToolUse Hooks: Automated validation and formatting after Copilot edits
• ✅ CLI Tool: Quick installation in any project

Installation

For GitHub Copilot (project):

npx @silverassist/agents-toolkit@latest install

For GitHub Copilot (global — all projects):

npx @silverassist/agents-toolkit@latest install --global

For Claude Code:

npx @silverassist/agents-toolkit@latest install --claude

For Codex:

npx @silverassist/agents-toolkit@latest install --codex

Setup

GitHub Copilot

Run the CLI to install prompts into your project:

npx @silverassist/agents-toolkit@latest install

This creates the following structure:

AGENTS.md                             # Copilot Coding Agent instructions (project root)
.github/
├── copilot-instructions.md           # Project-wide Copilot instructions
├── prompts/
│   ├── _partials/
│   ├── analyze-ticket.prompt.md
│   ├── create-plan.prompt.md
│   ├── work-ticket.prompt.md
│   └── ...
├── instructions/
│   ├── typescript.instructions.md
│   ├── react-components.instructions.md
│   ├── server-actions.instructions.md
│   ├── tests.instructions.md
│   └── css-styling.instructions.md
└── skills/
    ├── component-architecture/
    ├── domain-driven-design/
    └── testing-patterns/

Running prompts in VS Code:

• Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
• Search for "GitHub Copilot: Run Prompt"
• Select the desired prompt
• Fill in variables (e.g., {ticket-id})

Claude Code

Run the CLI with the --claude flag:

npx @silverassist/agents-toolkit@latest install --claude

This creates the following structure:

CLAUDE.md                             # Project instructions for Claude Code (project root)
.claude/
└── commands/
    ├── _partials/
    ├── analyze-ticket.md
    ├── create-plan.md
    ├── work-ticket.md
    └── ...
.github/
├── instructions/                     # Shared with Copilot
└── skills/                           # Shared with Copilot

Running commands in Claude Code:

Type / in the chat to see all available slash commands:

/analyze-ticket
/work-ticket
/create-pr

Codex

Run the CLI with the --codex flag:

npx @silverassist/agents-toolkit@latest install --codex

This creates the following structure:

AGENTS.md                             # Project instructions for Codex (project root)
.github/
├── prompts/
│   ├── _partials/
│   ├── analyze-ticket.prompt.md
│   ├── create-plan.prompt.md
│   ├── work-ticket.prompt.md
│   └── ...
├── instructions/
│   ├── typescript.instructions.md
│   ├── react-components.instructions.md
│   ├── server-actions.instructions.md
│   ├── tests.instructions.md
│   └── css-styling.instructions.md
└── skills/
    ├── component-architecture/
    ├── domain-driven-design/
    └── testing-patterns/

Global Install (Optional)

Install once and have instructions, prompts, and skills available across all your projects without running install in each one:

# Install everything to ~/.copilot/
npx @silverassist/agents-toolkit@latest install --global

# Filter by stack/tracker
npx @silverassist/agents-toolkit@latest install --global --stack wordpress
npx @silverassist/agents-toolkit@latest install --global --stack react --tracker github

# Update global install
npx @silverassist/agents-toolkit@latest update --global

This installs to ~/.copilot/ (instructions, prompts, skills) and creates ~/.agents-toolkit.json as the global config. Project-level files (AGENTS.md, copilot-instructions.md) are skipped since they are project-specific.

Config resolution order: CLI flags → project .agents-toolkit.json → global ~/.agents-toolkit.json → defaults.

Configure Project (Optional)

Update .agents-toolkit.json in your project root (created automatically):

{
  "stack": "react",
  "tracker": "github",
  "jira": {
    "projectKey": "WEB",
    "baseUrl": "https://your-org.atlassian.net"
  },
  "git": {
    "defaultBranch": "dev"
  }
}

Field	Values	Description
stack	react, wordpress, all	Filter instructions/skills by tech stack
tracker	github, jira, all	Filter prompts/partials by issue tracker
jira	object	Jira connection settings (when tracker is jira)
git	object	Git workflow settings

Available Prompts / Commands

The same set of prompts is available for all supported tools.

Workflow

Prompt / Command	Description	Variables	Tracker
analyze-ticket	Analyze a Jira ticket	{ticket-id}	Jira
analyze-github-issue	Analyze a GitHub issue	{issue-number}	GitHub
create-plan	Create implementation plan	{feature-description}	All
work-ticket	Start working on a Jira ticket	{ticket-id}	Jira
work-github-issue	Start working on a GitHub issue	{issue-number}	GitHub
prepare-pr	Prepare code for PR	—	All
create-pr	Create a pull request	{ticket-id}	Jira
finalize-pr	Finalize and merge PR	{ticket-id}	Jira

Utility

Prompt / Command	Description	Variables
review-code	Quick code review	—
fix-issues	Fix lint/type/test errors	—
add-tests	Add tests for components	{target-file}

Workflow Stages

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. Analyze     │────▶│  2. Plan        │────▶│  3. Work        │
│  analyze-ticket │     │  create-plan    │     │  work-ticket    │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                                                        │
                                                        ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  6. Finalize    │◀────│  5. Create PR   │◀────│  4. Prepare     │
│  finalize-pr    │     │  create-pr      │     │  prepare-pr     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

CLI Reference

install

Install prompts into your project. Does not overwrite existing files by default — safe to run multiple times.

npx @silverassist/agents-toolkit@latest install [options]

Option	Description
--global, -g	Install to ~/.copilot/ for all projects (user-level)
--target <name>	Target installer: copilot, claude, or codex
--stack <name>	Filter by tech stack: react, wordpress, or all (default)
--tracker <name>	Filter by issue tracker: github, jira, or all (default)
--claude	Install for Claude Code (.claude/commands/ + CLAUDE.md)
--codex	Install for Codex (AGENTS.md + shared .github files)
--append	Append missing sections to existing AGENTS.md (instead of overwrite)
--force, -f	Overwrite existing files
--prompts-only	Only install prompts / commands
--instructions-only	Only install instructions and instructions file
--partials-only	Only install partials
--skills-only	Only install skills
--hooks-only	Only install hooks (PostToolUse validation scripts)
--dry-run	Show what would be installed without making changes

Examples:

# GitHub Copilot — first install
npx @silverassist/agents-toolkit@latest install

# Claude Code — first install
npx @silverassist/agents-toolkit@latest install --claude

# Codex — first install
npx @silverassist/agents-toolkit@latest install --codex
npx @silverassist/agents-toolkit@latest install --target codex
npx @silverassist/agents-toolkit@latest install --target=claude

# Force overwrite all files
npx @silverassist/agents-toolkit@latest install --force
npx @silverassist/agents-toolkit@latest install --claude --force
npx @silverassist/agents-toolkit@latest install --codex --force

# Merge AGENTS.md sections without overwriting
npx @silverassist/agents-toolkit@latest install --codex --instructions-only --append

# Preview without installing
npx @silverassist/agents-toolkit@latest install --dry-run
npx @silverassist/agents-toolkit@latest install --claude --dry-run
npx @silverassist/agents-toolkit@latest install --codex --dry-run

# Filter by tech stack
npx @silverassist/agents-toolkit@latest install --stack react
npx @silverassist/agents-toolkit@latest install --stack wordpress

# Filter by issue tracker
npx @silverassist/agents-toolkit@latest install --tracker github
npx @silverassist/agents-toolkit@latest install --tracker jira

# Combine stack + tracker
npx @silverassist/agents-toolkit@latest install --stack react --tracker github
npx @silverassist/agents-toolkit@latest install --stack wordpress --tracker jira --claude

# Global install (all projects, no per-project setup needed)
npx @silverassist/agents-toolkit@latest install --global
npx @silverassist/agents-toolkit@latest install --global --stack wordpress
npx @silverassist/agents-toolkit@latest update --global

update

Update all prompts to the latest version. Overwrites existing files (equivalent to install --force).

npx @silverassist/agents-toolkit@latest update [options]
npx @silverassist/agents-toolkit@latest update --claude
npx @silverassist/agents-toolkit@latest update --codex

⚠️ Warning: This will replace any customizations you've made to the installed files.

list

List all available prompts and skills.

npx @silverassist/agents-toolkit@latest list

Command Comparison

Scenario	Command
First time installation (Copilot)	install
First time installation (Any target)	install --target <copilot|claude|codex>
First time installation (Claude)	install --claude
First time installation (Codex)	install --codex
Install once for all projects	install --global
Update global install	update --global
Add only new files (keep customizations)	install
Get latest version (discard customizations)	update
Update specific category only	update --prompts-only
Preview what would change	install --dry-run

Partials

Reusable prompt fragments shared between tools:

Partial	Description
validations.md	Code quality validation steps
git-operations.md	Git workflow operations
jira-integration.md	Jira/Atlassian MCP operations
github-integration.md	GitHub issue operations (MCP)
documentation.md	Documentation standards
pr-template.md	Pull request templates (GitHub Issues + Jira)

Instructions

File-type specific guidelines applied automatically by Copilot and available as shared references for Claude/Codex:

Instruction	Applies To	Description
typescript.instructions.md	*.ts, *.tsx	TypeScript best practices
react-components.instructions.md	*.tsx	React component patterns
server-actions.instructions.md	**/actions/*.ts	Next.js Server Actions
tests.instructions.md	*.test.ts, *.test.tsx	Testing patterns
css-styling.instructions.md	*.css, *.tsx	Tailwind CSS & shadcn/ui standards

Skills

Specialized knowledge guides for domain-specific patterns:

Skill	Description
component-architecture	React component patterns, folder structure, naming conventions
domain-driven-design	DDD principles, domain organization, barrel exports
testing-patterns	Jest + RTL patterns for Next.js 15 and Server Actions

GitHub Copilot — reference a skill explicitly:

@workspace Use the component-architecture skill to create a new payment form

Claude Code — skills are stored in .github/skills/ and can be referenced in any prompt or command.

Codex — skills are stored in .github/skills/ and can be referenced from AGENTS.md and task context.

Hooks

PostToolUse hooks run automatically after GitHub Copilot edits files. They provide real-time validation and formatting without manual intervention.

Hook	Trigger	Description
validate-tsx	*.tsx in components/	Validates kebab-case folders, index.tsx naming, default export, and Props interface
lint-format	*.ts, *.tsx, *.js, *.jsx, *.css	Runs ESLint --fix and Prettier --write on the modified file

Hooks are installed to:

• Project (default): .github/hooks/
• Global (--global): ~/.copilot/hooks/

.github/hooks/              # or ~/.copilot/hooks/ for global
├── validate-tsx.json       # Hook config (PostToolUse trigger)
├── lint-format.json        # Hook config (PostToolUse trigger)
└── scripts/
    ├── validate-tsx.sh     # Validation logic (exit 1 = warning)
    └── lint-format.sh      # Auto-fix logic (always exit 0)

Install only hooks:

# Project-level (hooks apply to this project only)
npx @silverassist/agents-toolkit@latest install --hooks-only

# Global (hooks apply to all Copilot sessions)
npx @silverassist/agents-toolkit@latest install --hooks-only --global

Agent Instructions Files

AGENTS.md (Copilot/Codex Agent)

Installed at the project root. Contains mandatory instructions for the coding agent working on issues autonomously:

• 4-phase workflow: Analysis → Planning → Implementation → Documentation
• Code conventions, React patterns, testing requirements, git guidelines

CLAUDE.md (Claude Code)

Installed at the project root with --claude. Contains project-wide instructions for Claude Code:

• Same 4-phase workflow adapted for Claude Code conventions
• Slash commands reference table
• Code conventions, React patterns, git guidelines

Requirements

• Node.js 18+
• Git installed and configured
• For Jira tracker: Atlassian MCP configured
• For GitHub tracker: GitHub MCP configured
• For GitHub Copilot: VS Code with GitHub Copilot extension
• For Claude Code: Claude Code CLI or VS Code extension
• For Codex: Codex CLI/session running at project root

License

PolyForm Noncommercial License 1.0.0

Links

• GitHub Repository
• npm Package
• GitHub Copilot Documentation
• Claude Code Documentation