# Open Knowledge Write Skill

Use when the user wants to create, author, write, or design a new Agent Skill (a...

- Repository: https://github.com/inkeep/open-knowledge (4756 stars)
- Category: Design
- License: GPL-3.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add inkeep/open-knowledge --skill open-knowledge-write-skill -g -a claude-code -y`
Codex: `npx skills add inkeep/open-knowledge --skill open-knowledge-write-skill -g -a codex -y`
Cursor: `npx skills add inkeep/open-knowledge --skill open-knowledge-write-skill -g -a cursor -y`
Gemini CLI: `npx skills add inkeep/open-knowledge --skill open-knowledge-write-skill -g -a gemini-cli -y`

## Description

Use when the user wants to create, author, write, or design a new Agent Skill (a SKILL.md), for OpenKnowledge or for their editors, including requests like 'help me write a skill', 'make a skill that…', 'turn this workflow into a skill', or improving an existing skill's triggering and discipline. Also use when capturing reusable agent guidance that should live as an installable skill rather than a one-off prompt. Covers choosing scope (project vs global), authoring inside a plugin or skills-distribution repo (write in the repo's own layout, never install), the SKILL.md frontmatter contract, progressive-disclosure structure, evaluating the skill, and installing it into the user's editors.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Writing an OpenKnowledge skill

You are helping the user author an **Agent Skill**, a `SKILL.md` file (plus
optional `references/` and `scripts/`) that teaches an AI agent how to do a
recurring task. In OpenKnowledge a skill is a first-class, versioned,
installable artifact: you author it with the `write` / `edit` skill verbs, then
`install` it into the user's editors.

Skills earn their keep by being **recognized at the right moment** and **followed
faithfully**. Most of the craft is in two places: a `description` that triggers
reliably, and a body short and concrete enough that the agent actually does what
it says. Work the stages below in order, but jump to where the user already is.

## Stage 1, Capture intent and classify the skill

The rest: https://github.com/inkeep/open-knowledge/blob/HEAD/packages/server/assets/skills/write-skill/SKILL.md