AgentSkillsCN

idae-skill-template

根据提示词，或通过复制本模板，为GitHub Copilot创建、优化、更新、搭建或分析智能体技能。适用于被要求“创建一个技能”、“制作一个新的技能”、“搭建一个技能”、“分析一个技能”，或在构建、审查、提升搭载资源的专用AI能力时使用。同样适用于被要求更新、优化、改进或分析现有技能时使用。生成具有恰当前言、目录结构，以及可选脚本/参考文献/资产文件夹的SKILL.md文件。

SKILL.md
--- frontmatter
name: idae-skill-template
description: 'Create, optimize, update, scaffold, or analyze Agent Skills for GitHub Copilot from prompts or by duplicating this template. Use when asked to "create a skill", "make a new skill", "scaffold a skill", "analyze a skill", or when building, reviewing, or improving specialized AI capabilities with bundled resources. Also use when asked to update, optimize, improve, or analyze an existing skill. Generates SKILL.md files with proper frontmatter, directory structure, and optional scripts/references/assets folders.'
metadata:
  author: Mydde
  version: "1.1"

Make Skill Template

A meta-skill for creating, optimizing, updating, or analyzing Agent Skills.

CRITICAL INSTRUCTION: If provided with a skill file to "analyze", "review", or "audit", DO NOT summarize or describe the content. You must maintain your role as a generator/auditor and output a Technical Action Plan (roadmap) to improve, fix, or validate that skill.

When to Use This Skill

  • •User asks to "create a skill", "make a new skill", "scaffold a skill", or "update a skill"
  • •User veut mettre à jour, optimiser, améliorer, ou analyser une skill existante
  • •User wants to add a specialized capability to their GitHub Copilot setup
  • •User needs help structuring a skill with bundled resources
  • •User wants to duplicate this template as a starting point
  • •User asks to "analyze a skill", "review a skill", or requests a skill audit

Prerequisites

  • •Understanding of what the skill should accomplish
  • •A clear, keyword-rich description of capabilities and triggers
  • •Knowledge of any bundled resources needed (scripts, references, assets, templates)

Core Behavior Rules

  • •No Meta-Analysis: Do not summarize the provided skill. Focus exclusively on actionable tasks.
  • •Action-Oriented: Always use a phased approach with checkboxes [ ].
  • •Imperative Mood: Use verbs like "Refactor", "Update", "Validate".

Creating or Updating a Skill

Step 1: Create or Locate the Skill Directory

Create a new folder with a lowercase, hyphenated name:

code

skills/<skill-name>/
└── SKILL.md          # Required

Step 2: Generate or Update SKILL.md with Frontmatter

Every skill requires YAML frontmatter with name and description. When updating, ensure these fields are current and reflect any new capabilities or triggers:

yaml
---
name: <skill-name>
description: "<What it does>. Use when <specific triggers, scenarios, keywords users might say>."
---

Frontmatter Field Requirements

FieldRequiredConstraints
nameYes1-64 chars, lowercase letters/numbers/hyphens only, must match folder name
descriptionYes1-1024 chars, must describe WHAT it does AND WHEN to use it
licenseNoLicense name or reference to bundled LICENSE.txt
compatibilityNo1-500 chars, environment requirements if needed
metadataNoKey-value pairs for additional properties
allowed-toolsNoSpace-delimited list of pre-approved tools (experimental)

Description Best Practices

CRITICAL: The description is the PRIMARY mechanism for automatic skill discovery. Include:

  1. •WHAT the skill does (capabilities)
  2. •WHEN to use it (triggers, scenarios, file types)
  3. •Keywords users might mention in prompts

Good example: description: 'Toolkit for testing local web applications using Playwright. Use when asked to verify frontend functionality, debug UI behavior, capture browser screenshots, or view browser console logs.'

Step 3: Write or Update the Skill Body

After the frontmatter, add or update markdown instructions. Recommended sections:

SectionPurpose
# TitleBrief overview
## When to Use This SkillReinforces description triggers
## Step-by-Step WorkflowsNumbered steps for tasks
## TroubleshootingCommon issues and solutions

Step 4: Add or Update Optional Directories (If Needed)

FolderPurposeWhen to Use
scripts/Executable code (Python, Bash, JS)Automation that performs operations
references/Documentation agent readsAPI references, schemas, guides
assets/Static files used AS-ISImages, fonts, templates

Quick Start: Duplicate or Update This Template

  1. •To create: Copy the make-skill-template/ folder
  2. •Rename to your skill name (lowercase, hyphens)
  3. •Update SKILL.md:
  • •Change name: to match folder name
  • •Write a keyword-rich description:
  1. •To update: Edit the existing SKILL.md to reflect new capabilities.

Validation Checklist (Mandatory for Audits)

  • • Folder name and name field match exactly (lowercase-hyphenated).
  • • description is 10-1024 characters and wrapped in single quotes.
  • • Logic includes specific edge cases and avoids conversational fluff.

Troubleshooting

IssueSolution
Skill not discoveredImprove description with more keywords and triggers
Validation fails on nameEnsure lowercase, no consecutive hyphens, matches folder
Skill summarizes itselfVerify the "Zero Meta-Description" rule in the body

References