Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: Technology-agnostic blueprint generator for creating comprehensive copilot-instructions.md files that guide GitHub Copilot to produce code consistent with project standards, architecture patterns, and exact technology versions by analyzing existing codebase patterns and avoiding assumptions.
metadata:
github-path: copilot-instructions-blueprint-generator
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-path: skills/copilot-instructions-blueprint-generator
github-ref: refs/heads/main
github-repo: https://github.com/github/awesome-copilot
github-tree-sha: a67fccf32fc28eda70e5868e65e61e2fce3e64ef
name: copilot-instructions-blueprint-generator
---
Expand Down
40 changes: 20 additions & 20 deletions .agents/skills/find-skills/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
---
description: Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
metadata:
github-path: find-skills
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-tree-sha: 9d01b3f7405bfefe19fa4e343c1841303f91889d
github-path: skills/find-skills
github-ref: refs/tags/v1.5.1
github-repo: https://github.com/vercel-labs/skills
github-tree-sha: 3013fdeb8a11b10b1eb795ec3ae8bfca38f7c26d
name: find-skills
---
# Find Skills
Expand All @@ -23,15 +22,16 @@ Use this skill when the user:
- Wants to search for tools, templates, or workflows
- Mentions they wish they had help with a specific domain (design, testing, deployment, etc.)

## What is `gh skill`?
## What is the Skills CLI?

`gh skill` (a GitHub CLI extension) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.
The Skills CLI (`npx skills`) is the package manager for the open agent skills ecosystem. Skills are modular packages that extend agent capabilities with specialized knowledge, workflows, and tools.

**Key commands:**

- `gh skill search [query]` - Search for skills by keyword
- `gh skill install <owner/repository> <skill> --agent github-copilot --scope user` - Install a skill from GitHub for Copilot
- `gh skill update` - Check for and apply skill updates
- `npx skills find [query]` - Search for skills interactively or by keyword
- `npx skills add <package>` - Install a skill from GitHub or other sources
- `npx skills check` - Check for skill updates
- `npx skills update` - Update all installed skills

**Browse skills at:** https://skills.sh/

Expand All @@ -58,14 +58,14 @@ For example, top skills for web development include:
If the leaderboard doesn't cover the user's need, run the find command:

```bash
gh skill search [query]
npx skills find [query]
```

For example:

- User asks "how do I make my React app faster?" → `gh skill search react performance`
- User asks "can you help me with PR reviews?" → `gh skill search pr review`
- User asks "I need to create a changelog" → `gh skill search changelog`
- User asks "how do I make my React app faster?" → `npx skills find react performance`
- User asks "can you help me with PR reviews?" → `npx skills find pr review`
- User asks "I need to create a changelog" → `npx skills find changelog`

### Step 4: Verify Quality Before Recommending

Expand All @@ -92,7 +92,7 @@ React and Next.js performance optimization guidelines from Vercel Engineering.
(185K installs)

To install it:
gh skill install vercel-labs/agent-skills react-best-practices --agent github-copilot --scope user
npx skills add vercel-labs/agent-skills@react-best-practices

Learn more: https://skills.sh/vercel-labs/agent-skills/react-best-practices
```
Expand All @@ -102,10 +102,10 @@ Learn more: https://skills.sh/vercel-labs/agent-skills/react-best-practices
If the user wants to proceed, you can install the skill for them:

```bash
gh skill install <owner/repository> <skill> --agent github-copilot --scope user
npx skills add <owner/repo@skill> -g -y
```

The `--scope user` flag installs for the user profile.
The `-g` flag installs globally (user-level) and `-y` skips confirmation prompts.

## Common Skill Categories

Expand Down Expand Up @@ -133,14 +133,14 @@ If no relevant skills exist:

1. Acknowledge that no existing skill was found
2. Offer to help with the task directly using your general capabilities
3. Suggest the user could create their own skill following the Agent Skills specification
3. Suggest the user could create their own skill with `npx skills init`

Example:

```
I searched for skills related to "xyz" but didn't find any matches.
I can still help you with this task directly! Would you like me to proceed?

If this is something you do often, you could create your own skill by following:
https://agentskills.io/specification
If this is something you do often, you could create your own skill:
npx skills init my-xyz-skill
```
7 changes: 3 additions & 4 deletions .agents/skills/gh-cli/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.
metadata:
github-path: gh-cli
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-path: skills/gh-cli
github-ref: refs/heads/main
github-repo: https://github.com/github/awesome-copilot
github-tree-sha: 437437f7f20bcdbbdb3081cf164435a388c0a39a
name: gh-cli
---
Expand Down
7 changes: 3 additions & 4 deletions .agents/skills/gh-stack/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,9 @@ description: |
Manage stacked branches and pull requests with the gh-stack GitHub CLI extension. Use when the user wants to create, push, rebase, sync, navigate, or view stacks of dependent PRs. Triggers on tasks involving stacked diffs, dependent pull requests, branch chains, or incremental code review workflows.
metadata:
author: github
github-path: gh-stack
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-path: skills/gh-stack
github-ref: refs/tags/v0.0.1
github-repo: https://github.com/github/gh-stack
github-tree-sha: f900e01d90dd042162d0632dc31ee9541dd07841
version: 0.0.1
name: gh-stack
Expand Down
7 changes: 3 additions & 4 deletions .agents/skills/git-commit/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,9 @@ allowed-tools: Bash
description: 'Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping'
license: MIT
metadata:
github-path: git-commit
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-path: skills/git-commit
github-ref: refs/heads/main
github-repo: https://github.com/github/awesome-copilot
github-tree-sha: 883a6a7466f55a9cd9f22cf1cce2d9333fc9b998
name: git-commit
---
Expand Down
21 changes: 10 additions & 11 deletions .agents/skills/github-actions-docs/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
---
description: Use when users ask how to write, explain, customize, migrate, secure, or troubleshoot GitHub Actions workflows, workflow syntax, triggers, matrices, runners, reusable workflows, artifacts, caching, secrets, OIDC, deployments, custom actions, or Actions Runner Controller, especially when they need official GitHub documentation, exact links, or docs-grounded YAML guidance.
metadata:
github-path: github-actions-docs
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-tree-sha: 3b0e64e871f9e83cb394e3ffff8cb9f6bda99deb
github-path: skills/github-actions-docs
github-ref: refs/heads/main
github-repo: https://github.com/xixu-me/skills
github-tree-sha: 518c85da555f91c346813aa5bb3cc62f9db8bfb3
name: github-actions-docs
---
GitHub Actions questions are easy to answer from stale memory. Use this skill to ground answers in official GitHub documentation and return the closest authoritative page instead of generic CI/CD advice.
Expand All @@ -25,10 +24,10 @@ Use this skill when the request is about:

Do not use this skill for:

- A specific failing PR check, missing workflow log, or CI failure triage. Use the `gh-cli` skill.
- General GitHub pull request, branch, or repository operations. Use the `gh-cli` skill.
- CodeQL-specific configuration or code scanning guidance. Search the GitHub docs directly.
- Dependabot configuration, grouping, or dependency update strategy. Search the GitHub docs directly.
- A specific failing PR check, missing workflow log, or CI failure triage. Use `gh-fix-ci`.
- General GitHub pull request, branch, or repository operations. Use `github`.
- CodeQL-specific configuration or code scanning guidance. Use `codeql`.
- Dependabot configuration, grouping, or dependency update strategy. Use `dependabot`.
Comment thread
devantler marked this conversation as resolved.

## Workflow

Expand Down Expand Up @@ -95,8 +94,8 @@ Keep citations close to the claim they support.
- Linking the GitHub Actions docs landing page when a narrower page exists
- Mixing up reusable workflows and composite actions
- Suggesting long-lived cloud credentials when OIDC is the better documented path
- Treating repo-specific CI debugging as a documentation question when it should be handed to `gh-cli`
- Letting adjacent domains absorb the request when a more focused search of GitHub docs is the sharper fit
- Treating repo-specific CI debugging as a documentation question when it should be handed to `gh-fix-ci`
- Letting adjacent domains absorb the request when `codeql` or `dependabot` is the sharper fit

## Bundled Reference

Expand Down
7 changes: 3 additions & 4 deletions .agents/skills/github-issues/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: Create, update, and manage GitHub issues using MCP tools. Use this skill when users want to create bug reports, feature requests, or task issues, update existing issues, add labels/assignees/milestones, set issue fields (dates, priority, custom fields), set issue types, manage issue workflows, link issues, add dependencies, or track blocked-by/blocking relationships. Triggers on requests like "create an issue", "file a bug", "request a feature", "update issue X", "set the priority", "set the start date", "link issues", "add dependency", "blocked by", "blocking", or any GitHub issue management task.
metadata:
github-path: github-issues
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-path: skills/github-issues
github-ref: refs/heads/main
github-repo: https://github.com/github/awesome-copilot
github-tree-sha: 44219c182a1435252a1751313b99fb0a79882bb5
name: github-issues
---
Expand Down
7 changes: 3 additions & 4 deletions .agents/skills/gitops-cluster-debug/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,9 @@ description: |
Debug and troubleshoot Flux CD on live Kubernetes clusters (not local repo files) via the Flux MCP server — inspects Flux resource status, reads controller logs, traces dependency chains, and performs installation health checks. Use when users report failing, stuck, or not-ready Flux resources on a cluster, reconciliation errors, controller issues, artifact pull failures, or need live cluster Flux Operator troubleshooting.
license: Apache-2.0
metadata:
github-path: gitops-cluster-debug
github-pinned: 5fe05e6dd751519bdc212d80499429651392ac7e
github-ref: 5fe05e6dd751519bdc212d80499429651392ac7e
github-repo: https://github.com/devantler-tech/skills
github-path: skills/gitops-cluster-debug
github-ref: refs/tags/v0.0.3
github-repo: https://github.com/fluxcd/agent-skills
github-tree-sha: f1463d4de7168c3561f680a2613c3b68578f09ca
name: gitops-cluster-debug
---
Expand Down
Loading
Loading