Openskills openskills-skill-authoring

Create and refine OpenSkills-compatible skills (SKILL.md + optional resources) with strong metadata, clear activation triggers, and reliable execution guidance.

install

source · Clone the upstream repo

git clone https://github.com/Geeksfino/openskills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/Geeksfino/openskills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.cursor/skills/openskills-skill-authoring" ~/.claude/skills/geeksfino-openskills-openskills-skill-authoring && rm -rf "$T"

manifest: .cursor/skills/openskills-skill-authoring/SKILL.md

source content

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

Keep core instructions short; move details to
```
references/
```
.
Prefer deterministic scripts for fragile or repetitive steps.
Include explicit input/output expectations.
Avoid vague names and ambiguous activation phrases.

Validation Flow

Ensure directory name matches skill
```
name
```
semantics.
Verify skill discovery and activation behavior in runtime or example agent.
If scripts are present, verify paths and execution assumptions.

Output Format

Skill metadata quality review
Instruction clarity review
Activation trigger quality review
Suggested revisions