@silverassist/agents-toolkit
Advanced tools
Reusable AI agent prompts for development workflows with Jira integration — supports GitHub Copilot, Claude Code, and Codex
Reusable AI agent prompts for development workflows — supports GitHub Copilot, Claude Code, and Codex with multi-stack and multi-tracker filtering.
--stack--tracker--globalFor 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
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
│ └── ... # 10 prompts total (depends on --tracker)
├── instructions/
│ ├── typescript.instructions.md
│ ├── react-components.instructions.md
│ └── ... # filtered by --stack
└── skills/ # Symlinks → ../../.agents/skills/ (npx skills standard)
├── domain-driven-design -> ../../.agents/skills/domain-driven-design
├── testing-patterns -> ../../.agents/skills/testing-patterns
└── ... # filtered by --stack
.agents/
└── skills/ # Canonical store (single source of truth)
├── domain-driven-design/
├── testing-patterns/
└── ... # 9 skills total, filtered by --stack
Skills follow the
npx skillsstandard. The real skill files live once in the canonical.agents/skills/store, and each agent'sskills/directory contains symlinks to it — a single source of truth shared across Copilot, Claude Code, and Codex. Use--copyto materialize real copies instead of symlinks (e.g. on Windows without developer mode; symlinks also fall back to copies automatically when unsupported).
Running prompts in VS Code:
Cmd+Shift+P / Ctrl+Shift+P){ticket-id})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)
.agents/
└── skills/ # Canonical skills store (single source of truth)
├── domain-driven-design/
├── testing-patterns/
└── ... # 9 skills total, filtered by --stack
.claude/
├── commands/
│ ├── _partials/
│ ├── analyze-ticket.md
│ ├── create-plan.md
│ ├── work-ticket.md
│ └── ... # 10 commands total (depends on --tracker)
└── skills/ # Symlinks → ../../.agents/skills/ (read natively by Claude Code)
├── domain-driven-design -> ../../.agents/skills/domain-driven-design
├── testing-patterns -> ../../.agents/skills/testing-patterns
└── ... # filtered by --stack
.github/
└── instructions/ # Shared with Copilot
Skills now install to
.claude/skills/(where Claude Code reads them natively) as symlinks to the canonical.agents/skills/store — no longer to.github/skills/.
Running commands in Claude Code:
Type / in the chat to see all available slash commands:
/analyze-github-issue
/work-github-issue
/create-github-pr
/finalize-github-pr
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
│ └── ... # 10 prompts total (depends on --tracker)
├── instructions/
│ ├── typescript.instructions.md
│ ├── react-components.instructions.md
│ └── ... # filtered by --stack
└── skills/ # Symlinks → ../../.agents/skills/ (npx skills standard)
├── domain-driven-design -> ../../.agents/skills/domain-driven-design
├── testing-patterns -> ../../.agents/skills/testing-patterns
└── ... # filtered by --stack
.agents/
└── skills/ # Canonical store (single source of truth)
├── domain-driven-design/
├── testing-patterns/
└── ... # 9 skills total, filtered by --stack
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.
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 |
The same set of prompts is available for all supported tools.
| 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 (Jira) | {ticket-id} | Jira |
create-github-pr | Create a pull request (GitHub) | {issue-number} | GitHub |
finalize-pr | Finalize and merge PR (Jira) | {ticket-id} | Jira |
finalize-github-pr | Finalize and merge PR (GitHub) | {issue-number} | GitHub |
prepare-github-release | Prepare a GitHub release (auto-detects WordPress vs Node, tag vs Release) | — | GitHub |
| Prompt / Command | Description | Variables |
|---|---|---|
review-code | Quick code review | — |
fix-issues | Fix lint/type/test errors | — |
add-tests | Add tests for components | {target-file} |
Jira workflow:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 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 │
└─────────────────┘ └─────────────────┘ └─────────────────┘
GitHub workflow:
┌──────────────────────┐ ┌─────────────────┐ ┌──────────────────────┐
│ 1. Analyze │────▶│ 2. Plan │────▶│ 3. Work │
│ analyze-github-issue│ │ create-plan │ │ work-github-issue │
└──────────────────────┘ └─────────────────┘ └──────────────────────┘
│
▼
┌──────────────────────┐ ┌──────────────────────┐ ┌─────────────────┐
│ 6. Finalize │◀────│ 5. Create PR │◀─│ 4. Prepare │
│ finalize-github-pr │ │ create-github-pr │ │ prepare-pr │
└──────────────────────┘ └──────────────────────┘ └─────────────────┘
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) |
--copy | Copy skills into each agent dir instead of symlinking to .agents/skills/ |
--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 all prompts to the latest version. Overwrites existing files and refreshes the skills lockfile (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.
Restore skills from the lockfile. Reads agents-toolkit-lock.json and reinstalls all skills with the correct symlinks. Designed for post-clone setup and CI pipelines.
npx @silverassist/agents-toolkit@latest restore
npx @silverassist/agents-toolkit@latest restore --force # overwrite existing files
npx @silverassist/agents-toolkit@latest restore --dry-run # preview only
If the lockfile was written by a different package version,
restorewarns but still proceeds.
Check whether installed skills match the lockfile. Useful in CI to detect drift (manually edited skills or stale installs).
npx @silverassist/agents-toolkit@latest status
Exits with code 0 if all skills are up-to-date, 1 if any skill is missing or modified.
List all available prompts and skills.
npx @silverassist/agents-toolkit@latest list
| 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 |
| Restore skills after clone / CI | restore |
| Check if skills are in sync | status |
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) |
release-node.md | Node/npm release bump & quality checks (used by prepare-github-release) |
release-wordpress.md | WordPress plugin release bump & quality checks (used by prepare-github-release) |
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 |
caching.instructions.md | next.config.*, src/proxy.ts, src/lib/**, **/route.ts, **/page.tsx | Next.js caching: read-vs-mutation fetch caching, ISR tiers, CDN invalidation |
seo-ai-optimization.instructions.md | *.tsx | Semantic HTML, accessibility tree, metadata, JSON-LD & E-E-A-T for AI Search |
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 |
nextjs-caching | Next.js caching strategy: read-vs-mutation fetch, ISR tiers, CDN invalidation, diagnosing dynamic-render leaks |
testing-patterns | Jest + RTL patterns for Next.js 15 and Server Actions |
Skills follow the npx skills standard: the real files live once in the canonical .agents/skills/ store, and each agent's skills/ directory symlinks to it (single source of truth, easy updates). Pass --copy to materialize real copies instead.
GitHub Copilot — skills are symlinked into .github/skills/. Reference a skill explicitly:
@workspace Use the component-architecture skill to create a new payment form
Claude Code — skills are symlinked into .claude/skills/, where Claude Code reads them natively, and can be referenced in any prompt or command.
Codex — skills are symlinked into .github/skills/ and can be referenced from AGENTS.md and task context.
When skills are installed, an agents-toolkit-lock.json file is written to the project root. This lockfile records each installed skill with its SHA-256 hash (same algorithm used by npx skills), allowing teammates and CI pipelines to restore the exact same skill files without committing them to the repository.
Recommended .gitignore entries (automatically appended by install):
# agents-toolkit managed — regenerate with: npx @silverassist/agents-toolkit restore
.agents/skills/
.github/skills/
.claude/skills/
Workflow:
# Developer A — installs and commits only the lockfile
npx @silverassist/agents-toolkit@latest install
git add agents-toolkit-lock.json
git commit -m "chore: add agents-toolkit skills"
# Developer B / CI — after cloning, restores skills from the lockfile
npx @silverassist/agents-toolkit@latest restore
# Check sync status in CI
npx @silverassist/agents-toolkit@latest status # exits 1 if any skill is missing/modified
# Update skills to latest package version
npx @silverassist/agents-toolkit@latest update # rewrites lockfile with new hashes
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:
.github/hooks/--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
How hook paths resolve. Copilot runs a hook
commandfrom the workspace root, not the hooks directory. Each generated config therefore sets acwdsoscripts/<name>.shresolves:.github/hooks(relative, portable) for project installs and the absolute hooks path for global installs. Configs also declare the requiredversion: 1field. If you installed hooks with an older version and seescripts/<name>.sh: No such file or directory, re-run the install with--forceto regenerate the configs.
Installed at the project root. Contains mandatory instructions for the coding agent working on issues autonomously:
Installed at the project root with --claude. Contains project-wide instructions for Claude Code:
The Jira and GitHub workflow prompts rely on MCP servers to read/write tickets and pull requests.
Add a .mcp.json file to your project root (or use VS Code's MCP settings) to register the servers:
{
"servers": {
"atlassian": {
"type": "http",
"url": "https://mcp.atlassian.com/v1/mcp"
},
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
}
}
}
You only need to include the server(s) matching your
--trackerchoice. The Atlassian MCP uses OAuth — authenticate once withnpx @atlassian/mcp-server author via the VS Code MCP UI. The GitHub MCP is authenticated automatically when you are signed in to GitHub Copilot.
PolyForm Noncommercial License 1.0.0
FAQs
Reusable AI agent prompts for development workflows with Jira integration — supports GitHub Copilot, Claude Code, and Codex
We found that @silverassist/agents-toolkit demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Benign-looking npm packages split malicious functionality across a dependency chain that deploys a cross-platform RAT targeting Alibaba developers.
Research
/Security News
Two Joyfill npm beta releases contain an import-time implant that uses blockchain transactions to retrieve a remote-access trojan.
Security News
Socket releases free Certified Patches for high-severity Nuxt vulnerabilities, including server-side remote code execution through server island props.