From 59c17eca47845c415f7567aaed19cb17a021ccd6 Mon Sep 17 00:00:00 2001 From: Gav Verma Date: Thu, 18 Dec 2025 19:06:07 -0800 Subject: [PATCH] Add short descriptions to system skills (#7) --- skills/.system/plan/SKILL.md | 2 ++ skills/.system/skill-creator/SKILL.md | 4 +++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/skills/.system/plan/SKILL.md b/skills/.system/plan/SKILL.md index f202ee9..5d49c33 100644 --- a/skills/.system/plan/SKILL.md +++ b/skills/.system/plan/SKILL.md @@ -1,6 +1,8 @@ --- name: plan description: Generate a plan for how an agent should accomplish a complex coding task. Use when a user asks for a plan, and optionally when they want to save, find, read, update, or delete plan files in $CODEX_HOME/plans (default ~/.codex/plans). +metadata: + short-description: Generate a plan for a complex task --- # Plan diff --git a/skills/.system/skill-creator/SKILL.md b/skills/.system/skill-creator/SKILL.md index 68700cf..f061c96 100644 --- a/skills/.system/skill-creator/SKILL.md +++ b/skills/.system/skill-creator/SKILL.md @@ -1,6 +1,8 @@ --- name: skill-creator description: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations. +metadata: + short-description: Create or update a skill --- # Skill Creator @@ -108,7 +110,7 @@ A skill should only contain essential files that directly support its functional - CHANGELOG.md - etc. -The skill should only contain the information needed for an AI agent to do the job at hand. It should not contain auxilary context about the process that went into creating it, setup and testing procedures, user-facing documentation, etc. Creating additional documentation files just adds clutter and confusion. +The skill should only contain the information needed for an AI agent to do the job at hand. It should not contain auxiliary context about the process that went into creating it, setup and testing procedures, user-facing documentation, etc. Creating additional documentation files just adds clutter and confusion. ### Progressive Disclosure Design Principle