Use when validating skill directory structure, reindexing skills for Perfect Skill Suggester, or managing skill activation and discovery. Trigger with skill validation, indexing, or update requests.
npx claudepluginhub emasoft/emasoft-plugins --plugin emasoft-chief-of-staffThis skill uses the workspace's default tool permissions.
Skill management enables the Chief of Staff to validate, index, and maintain agent skills across plugins and projects. This skill teaches you how to validate skill directory structure, trigger skill reindexing for Perfect Skill Suggester, and manage skill activation and discovery.
Creates, synthesizes, and iteratively improves agent skills per Agent Skills spec. Handles source capture, authoring, iteration from examples, updates, registration, and validation.
Creates and improves agent skills following the Agent Skills specification using workflows for synthesis, iteration, authoring, evaluation, and optimization. Use for skill creation, updates, or refinement requests.
Guides creation of Agent Skills with progressive disclosure, best practices, structure, and categories. Use when building new skills or understanding skill format.
Share bugs, ideas, or general feedback.
Skill management enables the Chief of Staff to validate, index, and maintain agent skills across plugins and projects. This skill teaches you how to validate skill directory structure, trigger skill reindexing for Perfect Skill Suggester, and manage skill activation and discovery.
Before using this skill, ensure:
| Operation | Output |
|---|---|
| Validate | Validation report with issues |
| Reindex | PSS index updated |
| Update | Skill content modified, agents notified |
Skill management is the administration of agent skills that provide specialized knowledge and procedures. It includes:
┌─────────────────────────────────────────────────────────┐
│ SKILL DIRECTORY │
│ ┌─────────────────────────────────────────────────┐ │
│ │ SKILL.md │ │
│ │ - YAML frontmatter (name, description, etc.) │ │
│ │ - Procedures with TOC │ │
│ │ - References links │ │
│ └─────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ references/ │ │
│ │ - Detailed procedure documentation │ │
│ │ - Each file has own TOC │ │
│ └─────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ scripts/ (optional) │ │
│ │ - Automation helpers │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────┐
│ PERFECT SKILL SUGGESTER │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Skill Index │ │
│ │ - Keywords extracted from skills │ │
│ │ - Co-usage relationships │ │
│ │ - Weighted scoring for activation │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
When to use: Before publishing a skill, after modifying skill files, or when skill fails to load.
Steps: Run skills-ref validate, check YAML frontmatter, verify references exist, confirm TOC accuracy.
Related documentation:
When to use: After adding new skills, after modifying skill content, or when PSS suggestions are stale.
Steps: Run pss-reindex-skills command, verify index updated, test skill discovery.
Related documentation:
When to use: When optimizing skill discovery, adjusting keyword weights, or customizing activation behavior.
Steps: Review skill descriptions, add activation keywords, configure weights, test discovery.
Related documentation:
These operational runbooks provide step-by-step instructions for executing each skill management procedure. Use them as quick-reference guides when performing the corresponding operation.
Runbook for validating a skill directory structure, YAML frontmatter, reference links, and TOC accuracy using skills-ref and manual checks.
Runbook for triggering a skill reindex to update the Perfect Skill Suggester index after adding or modifying skills.
Runbook for generating available_skills XML blocks using skills-ref to-prompt for embedding into agent prompt definitions.
Runbook for optimizing a skill's description, keywords, categories, and co-usage hints to improve discovery by the Perfect Skill Suggester.
Copy this checklist and track your progress:
# Install skills-ref if not present
pip install skills-ref
# Validate a skill directory
skills-ref validate /path/to/my-skill
# Expected output for valid skill
# Skill: my-skill
# Status: VALID
# Warnings: 0
# Errors: 0
# Read skill properties
skills-ref read-properties /path/to/my-skill
---
name: ecos-staff-planning
description: Use when analyzing staffing needs, assessing role requirements, planning agent capacity, or creating staffing templates for multi-agent orchestration
license: Apache-2.0
compatibility: Requires access to agent registry, project configuration files, and understanding of agent capabilities and workload patterns.
metadata:
author: Emasoft
version: 1.0.0
context: fork
---
# Using PSS slash command
/pss-reindex-skills
# Or via script
python scripts/pss_reindex_skills.py --skills-dir /path/to/skills
# Verify index updated
cat ~/.claude/skills-index.json | jq '.skills | length'
# Generate available_skills XML for agent prompts
skills-ref to-prompt /path/to/skill-a /path/to/skill-b
# Output
# <available_skills>
# <skill>
# <name>skill-a</name>
# <description>What skill-a does</description>
# <location>/path/to/skill-a/SKILL.md</location>
# </skill>
# ...
# </available_skills>
Symptoms: skills-ref reports errors, missing fields, broken links.
See references/skill-validation.md Section 1.7 Troubleshooting for resolution.
Symptoms: Skill indexed but not suggested, wrong skills activated.
See references/skill-reindexing.md Section 2.7 Troubleshooting for resolution.
Symptoms: Irrelevant skills suggested, relevant skills missed.
See references/pss-integration.md Section 3.7 Troubleshooting for resolution.
See references/skill-validation.md for validation procedures.
See references/skill-reindexing.md for reindexing procedures.
See references/pss-integration.md for discovery optimization.
Version: 1.0 Last Updated: 2025-02-01 Target Audience: Chief of Staff Agents Difficulty Level: Intermediate