Microsoft Skill Creator
MicrosoftDocs/mcp
Create agent skills for Microsoft technologies using official documentation.
Design and development best practices for Claude Code skills, MCP tools, and AI agent capabilities.
$ npx skills add pproenca/dot-skills --skill skill-authoring -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pproenca/dot-skills skill-authoring --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/skill-authoring .claude/skills/skill-authoring && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "skill-authoring" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoring into .claude/skills/skill-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-authoring", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoringType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pproenca/dot-skills --skill skill-authoring -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pproenca/dot-skills skill-authoring --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/.curated/skill-authoring .agents/skills/skill-authoring && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "skill-authoring" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoring into .agents/skills/skill-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-authoring", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill skill-authoring -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pproenca/dot-skills skill-authoring --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/.curated/skill-authoring .cursor/skills/skill-authoring && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "skill-authoring" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoring into .cursor/skills/skill-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-authoring", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pproenca/dot-skills.git --path skills/.curated/skill-authoring--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pproenca/dot-skills --skill skill-authoring -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pproenca/dot-skills skill-authoring --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/.curated/skill-authoring .gemini/skills/skill-authoring && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "skill-authoring" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoring into .gemini/skills/skill-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-authoring", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pproenca/dot-skills skill-authoringInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pproenca/dot-skills --skill skill-authoring -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/.curated/skill-authoring .github/skills/skill-authoring && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "skill-authoring" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoring into .github/skills/skill-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-authoring", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/dot-skills --skill skill-authoring -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pproenca/dot-skills skill-authoring --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/dot-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/.curated/skill-authoring .opencode/skills/skill-authoring && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "skill-authoring" agent skill from https://github.com/pproenca/dot-skills/tree/master/skills/.curated/skill-authoring into .opencode/skills/skill-authoring/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "skill-authoring", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
skill-authoringDesign and development best practices for Claude Code skills, MCP tools, and AI agent capabilities.
Skill Authoring is an agent skill from pproenca/dot-skills. Design and development best practices for Claude Code skills, MCP tools, and AI agent capabilities. Use when creating skills, writing SKILL.md files, designing tool descriptions, or optimizing triggers. Triggers on "create a skill", "skill template", "write skill instructions", SKILL.md, metadata.json, progressive disclosure, trigger optimization, MCP tool design, or skill testing. Does NOT cover specific frameworks or languages (use dedicated skills).
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 54 other files, including reference files and assets (for example `AGENTS.md`, `assets/templates/_template.md` and `metadata.json`).
It sits in Agent Workflows, covering Skill authoring and MCP servers. The repository describes itself as: A collection of AI agent skills following the Agent Skills open format. The licence is MIT.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit cf93c57. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml).
From the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
github.comanthropic.comcode.claude.commodelcontextprotocol.infopromptingguide.aileehanchung.github.ioFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Skill Authoring loads about 1.8k tokens when it runs, and up to ~22k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 640 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from pproenca/dot-skills at commit cf93c57, republished under its MIT licence (© pproenca). 640 words, ~1,811 tokens.
.claude/skills/skill-authoring/SKILL.md (or your agent's skills folder). This skill also uses 51 other files; get the full folder from GitHub.Design and development guide for AI agent skills, including Claude Code skills and MCP tools. Contains 46 rules across 8 categories, prioritized by impact to guide skill creation, review, and optimization.
1. Descriptions drive activation. Claude selects skills based on description matching against user intent. Include specific capabilities, trigger keywords, and negative cases. A skill with a vague description activates inconsistently or never.
2. Front-load critical instructions. Claude may truncate long content. Place non-negotiable rules in the first 100 lines. Bury important constraints at the end and they get ignored.
3. Progressive disclosure saves tokens. Load detailed content only when needed. A 2000-line skill wastes context on every activation. Structure as: SKILL.md (overview) → references/ (details) → scripts/ (execution).
4. Test activation, not just execution. A skill that works perfectly but never triggers provides zero value. Test with real user phrases, synonyms, and edge cases before deployment.
5. One skill per domain. Overlapping skills create activation conflicts. Split by clear boundaries (language, framework, workflow stage) with distinct trigger keywords.
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Skill Metadata Design | CRITICAL | meta- |
| 2 | Description Engineering | CRITICAL | desc- |
| 3 | Content Structure | HIGH | struct- |
| 4 | Trigger Optimization | HIGH | trigger- |
| 5 | Progressive Disclosure | MEDIUM-HIGH | prog- |
| 6 | MCP Tool Design | MEDIUM | mcp- |
| 7 | Testing and Validation | MEDIUM | test- |
| 8 | Maintenance and Distribution | LOW-MEDIUM | maint- |
meta-name-format - Use lowercase hyphenated skill namesmeta-name-hyphen-boundaries - Never start or end names with hyphensmeta-name-no-consecutive-hyphens - Avoid consecutive hyphens in namesmeta-name-uniqueness - Ensure skill names are globally uniquemeta-required-frontmatter - Include all required frontmatter fieldsmeta-allowed-frontmatter-fields - Use only allowed frontmatter fieldsmeta-frontmatter-yaml-syntax - Use valid YAML frontmatter syntaxmeta-name-length - Keep skill names under 64 charactersmeta-directory-match - Match skill name to directory namedesc-specific-capabilities - Name specific capabilities in descriptiondesc-trigger-keywords - Include user trigger keywords in descriptiondesc-third-person-voice - Write descriptions in third persondesc-length-optimization - Optimize description length for discoverydesc-avoid-vague-terms - Avoid vague terms in descriptionsdesc-differentiate-similar-skills - Differentiate similar skills with distinct triggersdesc-include-negative-cases - Include negative cases for precisionstruct-header-hierarchy - Use consistent header hierarchystruct-instructions-first - Put critical instructions early in contentstruct-imperative-instructions - Write instructions in imperative moodstruct-code-blocks-with-language - Specify language in code blocksstruct-line-limit - Keep SKILL.md under 500 linesstruct-single-responsibility - One skill per domainproject-conventions - Preserve repository-specific skill conventionstrigger-slash-command-aliases - Include slash command aliases in descriptiontrigger-file-type-patterns - Include file type patterns in descriptiontrigger-workflow-stages - Reference workflow stages in descriptiontrigger-error-patterns - Include error patterns in debugging skillstrigger-synonym-coverage - Cover synonyms and alternate phrasingsprog-three-level-disclosure - Implement three-level progressive disclosureprog-one-level-deep-links - Limit reference links to one level deepprog-scripts-execute-not-read - Execute scripts instead of reading codeprog-lazy-load-examples - Lazy load examples and reference materialprog-mutual-exclusion - Separate mutually exclusive contextsmcp-tool-naming - Use clear action-object tool namesmcp-parameter-descriptions - Document all tool parametersmcp-error-messages - Return actionable error messagesmcp-tool-scope - Design single-purpose toolsmcp-allowed-tools - Use allowed-tools for safety constraintsmcp-idempotent-operations - Design idempotent tool operationstest-trigger-phrases - Test skill activation with real user phrasestest-edge-cases - Test skills with edge case inputstest-negative-scenarios - Test that skills do NOT trigger on unrelated requeststest-instruction-clarity - Test instructions with fresh contextmaint-semantic-versioning - Use semantic versioning for skill releasesmaint-changelog - Maintain a changelog for skill updatesmaint-plugin-packaging - Package skills as plugins for distributionmaint-audit-security - Audit skills before installing from external sourcesCopy assets/templates/_template.md and follow the frontmatter schema:
---
title: Rule Title Here
impact: CRITICAL|HIGH|MEDIUM-HIGH|MEDIUM|LOW-MEDIUM|LOW
impactDescription: Quantified impact (e.g., "2-10x improvement")
tags: prefix, technique, related-concepts
---Reference files use the pattern: references/{prefix}-{slug}.md
© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 51 other files (references, assets) in skills/.curated/skill-authoring of pproenca/dot-skills.
Open the folder on GitHubat commit cf93c57
Skill Authoring next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Skill Authoring this skillpproenca/dot-skills | 215 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Microsoft Skill CreatorMicrosoftDocs/mcp | 1.9k | 3 repos | ~2.1k | Automated safety check: Pass | CC-BY-4.0 | |
| Skill Seekers Builderyusufkaraaslan/Skill_Seekers | 15k | — | ~760 | Automated safety check: Pass | MIT | |
| Mistral Vibe Plugin Creatormistralai/mistral-vibe | 5.1k | — | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Workflow Schema Tuningbreaking-brake/cc-wf-studio | 5.4k | — | ~1.3k | Automated safety check: Pass | Custom licence | |
| Muse Plugin Creatorasgeirtj/system_prompts_leaks | 69k | — | ~1.8k | Automated safety check: Pass | CC0-1.0 |
MicrosoftDocs/mcp
Create agent skills for Microsoft technologies using official documentation.
yusufkaraaslan/Skill_Seekers
Detects the type of a knowledge source and uses the Skill Seekers MCP tools to turn docs, repos, PDFs or videos into packaged AI skills.
mistralai/mistral-vibe
Shows how to build a Vibe plugin package in the Agent Plugins 1.0 format, with a plugin.json manifest and optional skills, MCP servers, hooks and other components.
breaking-brake/cc-wf-studio
Guides edits to cc-wf-studio's workflow schema so AI agents generate better workflows, treating schema text as prompt engineering rather than validation.
asgeirtj/system_prompts_leaks
Creates and validates a new native Muse plugin package in the current workspace, limited to five capability families, and leaves installation to you.
codewhale-hq/Codewhale
Guides creating or improving codewhale skills: file layout, discovery paths, writing rules and whether a need fits a skill, an MCP server, hooks or a plugin.
pproenca/dot-skills
Audio forensics and voice recovery guidelines for CSI-level audio analysis.
pproenca/dot-skills
Guided, scripted pipeline for running JSX/TSX/React codemods safely across large legacy codebases.
pproenca/dot-skills
Create well-structured RFCs and technical proposals for software projects.
pproenca/dot-skills
Developer-experience friction auditing and fixing — slow onboarding, repeated manual setup steps, missing bootstrap/reset/seed scripts, undiscoverable conventions.
pproenca/dot-skills
Turn a rough idea for a language into a complete, implementable specification — a DSL, query, config/data, template, or protocol language — by interviewing the author dimension by dimension until…
pproenca/dot-skills
Drafting Python Enhancement Proposals (PEPs) — proposing a Python language feature, a standard library change, an interoperability standard, or an informational/process document for the Python…
Categories
Design and development best practices for Claude Code skills, MCP tools, and AI agent capabilities. Skill Authoring is an agent skill from pproenca/dot-skills. Design and development best practices for Claude Code skills, MCP tools, and AI agent capabilities.
Skill Authoring fits situations like: creating skills; writing SKILL.md files; designing tool descriptions; optimizing triggers.
Run `npx skills add pproenca/dot-skills --skill skill-authoring -a claude-code`. Or copy the skill folder (skills/.curated/skill-authoring in pproenca/dot-skills) into .claude/skills/skill-authoring in your project. Claude Code loads it when a task matches its description.
Run `npx skills add pproenca/dot-skills --skill skill-authoring -a codex`. Or copy the skill folder (skills/.curated/skill-authoring in pproenca/dot-skills) into .agents/skills/skill-authoring in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/dot-skills --skill skill-authoring -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-authoring, .gemini/skills/skill-authoring, .github/skills/skill-authoring and .opencode/skills/skill-authoring in your project.
SKILL.md names no scripts, command-line tools or credentials: Skill Authoring is instructions for the agent only.
SKILL.md names 6 domains. As links in the text: github.com, anthropic.com, code.claude.com, modelcontextprotocol.info, promptingguide.ai and leehanchung.github.io. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Skill Authoring is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 21k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Skill Authoring: Microsoft Skill Creator (MicrosoftDocs/mcp, 1.9k stars), Skill Seekers Builder (yusufkaraaslan/Skill_Seekers, 15k stars), Mistral Vibe Plugin Creator (mistralai/mistral-vibe, 5.1k stars) and Workflow Schema Tuning (breaking-brake/cc-wf-studio, 5.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
pproenca (a GitHub user) maintains it in pproenca/dot-skills, which has 215 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on August 15, 2026.
Source: pproenca/dot-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.