skill-writer

Create and validate Agent Skills with SKILL.md frontmatter and directory structure.

2.5k|521|Updated May 29, 2019

Ready to run

npx skills add https://github.com/TencentBlueKing/bk-ci --skill skill-writer-tencentblueking

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/TencentBlueKing/bk-ci/tree/main/ai/skills/skill-writer
Command: npx skills add https://github.com/TencentBlueKing/bk-ci --skill skill-writer-tencentblueking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Skill design in teams often lacks a consistent structure for SKILL.md files, forcing repeated setup and confusion. This guide helps you create well-formed Skill Units, with clear frontmatter, directory layout, and activation-ready instructions.

Core Features & Use Cases

Define Skill scope and placement (project-level vs user-level) for CodeBuddy, Cursor, or other IDEs.
Validate frontmatter, naming conventions, and description to ensure reliable discovery and activation.
Generate a ready-to-use SKILL.md with step-by-step guidance and optional references/scripts.

Quick Start

Create a new Skill Unit directory named skill-writer under your IDE's skills folder.
Add SKILL.md with name: skill-writer and a concise description; include frontmatter and basic structure as shown here.
Optionally add references/ scripts/ assets directories to extend the Skill.

Frequently Asked Questions about skill-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create a standard SKILL.md file for IDE Agent Skills?▼

To create a standard SKILL.md file, define the Skill scope, validate frontmatter and naming conventions, and generate the file with step-by-step guidance to ensure reliable discovery and activation in IDEs like CodeBuddy or Cursor.

What is the correct directory structure for an Agent Skill?▼

The correct directory structure for an Agent Skill requires a dedicated Skill Unit directory under your IDE's skills folder, containing a SKILL.md file and optionally including references, scripts, and assets directories to extend functionality.

Can I use Skill Writer to standardize Agent Skill creation for both project-level and user-level scopes?▼

Yes, you can use it to define Skill placement for both project-level and user-level scopes. It guides you in standardizing Skill creation for CodeBuddy, Cursor, or other IDEs to ensure consistency across teams.

Why does my IDE Agent Skill fail to activate properly?▼

Agent Skill activation often fails due to incorrect frontmatter, naming conventions, or directory placement. Validating these elements ensures the Skill is properly discovered and reliably activated by the IDE.

What's the best way to validate Agent Skill frontmatter before deployment?▼

The best way to validate Agent Skill frontmatter is to follow a guided validation process that checks naming conventions, descriptions, and structure, ensuring the generated SKILL.md is consistent, reusable, and activation-ready.