Skip to content

Install authoritative meta-skills for skill creation and discovery - #19

Merged
dubzrn merged 1 commit into
mainfrom
copilot/install-meta-skills
Aug 24, 2026
Merged

Install authoritative meta-skills for skill creation and discovery#19
dubzrn merged 1 commit into
mainfrom
copilot/install-meta-skills

Conversation

Copilot AI commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

The repo needed canonical meta-skills for building and navigating skills rather than relying on fragmented guidance scattered across repositories. I installed the most authoritative, widely used patterns as actual agent skills under .github/skills so they are discoverable and usable as first-class capabilities.

  • Scope

    • Add the canonical "create a skill" workflow used by Anthropic’s official skill ecosystem.
    • Add the canonical "find the right skill" workflow used by the VRIL skill-jam pattern for discovery and sequencing.
    • Keep the manifest metadata compact and agent-friendly so the skills trigger correctly without overbroad instructions.
  • Changes

    • skill-creator

      • Added a meta-skill that covers intent capture, workflow-to-skill conversion, drafting SKILL.md, testing/prompts, eval iteration, and trigger optimization.
      • Encodes the production pattern: define the job, write the manifest, evaluate against real prompts, and refine until output and execution are reliable.
      • Keeps the guidance explicit about boundaries, progressive disclosure, and outputs so the skill remains useful and scoped.
    • skill-navigator

      • Added a meta-skill for deciding whether a skill is needed, narrowing candidate skills by trigger conditions, and sequencing them by task phase.
      • Emphasizes the right selection criteria: task structure, domain fit, output contract, token efficiency, and invocation timing.
      • Provides a consistent output format for recommending the best skill or chain without forcing a skill on tasks that are better handled inline.
    • Packaging

      • Installed both as actual skills in .github/skills/skill-creator/SKILL.md and .github/skills/skill-navigator/SKILL.md.
      • Included structured YAML frontmatter and concise descriptions to make them discoverable by agent skill runtimes.
  • Example

---
name: skill-creator
description: >
  Create new agent skills, improve existing ones, and evaluate their performance with test cases.
  Use when a user wants to turn a workflow into a reusable skill, refine a SKILL.md, optimize
  triggering and output contracts, or benchmark a skill against a baseline.
---

…ills

Co-authored-by: dubzrn <160236131+dubzrn@users.noreply.github.com>
@dubzrn
dubzrn marked this pull request as ready for review August 24, 2026 00:20
Copilot AI lite review requested due to automatic review settings August 24, 2026 00:20
@dubzrn
dubzrn merged commit e5e7204 into main Aug 24, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds two meta-skills under .github/skills/ intended to provide canonical workflows for skill creation and skill discovery/selection, so agents can invoke these as first-class capabilities.

Changes:

  • Added a new skill-creator meta-skill documenting a workflow for drafting, testing, and iterating on skills.
  • Added a new skill-navigator meta-skill documenting a workflow for choosing and sequencing skills, with an output format and examples.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
.github/skills/skill-navigator/SKILL.md Adds a skill-selection/navigation meta-skill (process + output format + examples).
.github/skills/skill-creator/SKILL.md Adds a skill-authoring meta-skill (intent capture → draft → evals → iteration).

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +1 to +6
---
name: skill-navigator
description: >
Find the right agent skill for a task, decide when to use a skill vs. inline reasoning, and sequence
skill calls efficiently. Use when the user asks which skill to use, when the workflow is uncertain,
or when a task would benefit from a proven reusable process.
Comment on lines +1 to +7
---
name: skill-creator
description: >
Create new agent skills, improve existing ones, and evaluate their performance with test cases.
Use when a user wants to turn a workflow into a reusable skill, refine a SKILL.md, optimize
triggering and output contracts, or benchmark a skill against a baseline.
---
Comment on lines +136 to +140
**Task**: Add PostgreSQL migration workflow to a Node.js project
**Recommended skill(s)**: `codebase-recon`, `database-migration`
**Invocation timing**: Start with `codebase-recon` now, then use `database-migration` before implementing
**Rationale**: `codebase-recon` finds reference patterns and existing conventions first, while `database-migration` encodes the actual migration process and common failure modes.
**Chain**: `codebase-recon` → `database-migration` → implement → validate
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants