Skip to content
Everruns Cloud is open in early access. Run agents without operating the platform.

Skill packages and their content.

CommandWhat it does
skills createCreate a new skill from SKILL.md content.
skills deleteArchive a skill (soft delete).
skills destroyPermanently delete an archived skill.
skills getGet a single skill by ID.
skills contentGet full skill content (SKILL.md + files).
skills listList all active skills.
skills usageCount agents and harnesses referencing each skill capability.
skills updateUpdate a skill.

Create a new skill from SKILL.md content.

Terminal window
everruns skills create [OPTIONS] --skill-md <skill_md>
FlagDescription
--skill-md <SKILL_MD>Required. Full SKILL.md content (YAML frontmatter + markdown body)

Example:

Terminal window
# Add a skill from a local file
everruns skills create --skill-md "$(cat SKILL.md)" --reason 'Share the code-review checklist'

Archive a skill (soft delete). Can be restored.

Terminal window
everruns skills delete [OPTIONS] [ID]
FlagDescription
--id <ID>Prefixed public identifier.

Example:

Terminal window
# Archive a skill, keeping it restorable
everruns skills delete skill_01h9 --reason 'Superseded by the shared review skill'

Permanently delete an archived skill.

Terminal window
everruns skills destroy [OPTIONS] [ID]
FlagDescription
--id <ID>Prefixed public identifier.

Example:

Terminal window
# Permanently remove an already-archived skill
everruns skills destroy skill_01h9 --reason 'Retired after the archive window'

Get a single skill by ID.

Terminal window
everruns skills get [OPTIONS] [ID]
FlagDescription
--id <ID>Prefixed public identifier.

Example:

Terminal window
# Show one skill's metadata without its body
everruns skills get skill_01h9

Get full skill content (SKILL.md + files).

Terminal window
everruns skills content [OPTIONS] [ID]
FlagDescription
--id <ID>Prefixed public identifier.

Example:

Terminal window
# Read a skill's body to see what it instructs
everruns skills content skill_01h9

List all active skills. Use search for name search, include_archived=true to include archived.

Terminal window
everruns skills list [OPTIONS]
FlagDescription
--include-archivedInclude archived skills.
--search <SEARCH>Search by name or description (case-insensitive substring match).

Example:

Terminal window
# Find skills by name when you do not know the id
everruns skills list --search code-review

Count agents and harnesses referencing each skill capability.

Terminal window
everruns skills usage [OPTIONS]

Example:

Terminal window
# See which agents use which skills
everruns skills usage

Update a skill. Only provided fields are changed.

Terminal window
everruns skills update [OPTIONS] [ID]
FlagDescription
--id <ID>Prefixed public identifier.
--skill-md <SKILL_MD>Updated SKILL.md content (re-parses frontmatter)
--status <STATUS>

Example:

Terminal window
# Replace a skill's content from a local file
everruns skills update skill_01h9 --skill-md "$(cat SKILL.md)" --reason 'Add the security review step'