# Openskills Skill Authoring > Create and refine OpenSkills-compatible skills (SKILL.md + optional resources) with strong metadata, clear activation triggers, and reliable execution guidance. Use when this capability is needed. - Skill: `tomevault-io/openskills-skill-authoring` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/openskills-skill-authoring` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/openskills-skill-authoring/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/openskills-skill-authoring --- # OpenSkills Skill Authoring Use this skill when creating or updating skills under `examples/skills` or any OpenSkills-compatible skill directory. ## Authoring Standard Each skill directory should include: - `SKILL.md` (required) - optional `scripts/`, `references/`, `assets/` ## SKILL.md Requirements - YAML frontmatter with: - `name` - `description` - Body with concise instructions and practical execution flow. - Description must include both: - what the skill does - when to activate it ## Writing Guidance 1. Keep core instructions short; move details to `references/`. 2. Prefer deterministic scripts for fragile or repetitive steps. 3. Include explicit input/output expectations. 4. Avoid vague names and ambiguous activation phrases. ## Validation Flow 1. Ensure directory name matches skill `name` semantics. 2. Verify skill discovery and activation behavior in runtime or example agent. 3. If scripts are present, verify paths and execution assumptions. ## Output Format - Skill metadata quality review - Instruction clarity review - Activation trigger quality review - Suggested revisions --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/geeksfino) — claim your Tome and manage your conversions.