Create Skill Route

post/skills

Request

  • Base URL: https://api.goodeye.dev/v1
  • URL: https://api.goodeye.dev/v1/skills
  • Auth: none declared

Request body

namestring required

Skill name in kebab-case (lowercase letters, digits, and hyphens). Doubles as the slug and is unique within your namespace.

skill_idstring uuid nullable

Target a specific skill to edit. Omit it to save in your own namespace: the call updates your own skill of this name, or creates a new one. Supply it to update a specific skill you own or have edit access to; name must match that skill's name.

descriptionstring required

One-sentence summary of what the skill does and when to use it. This is the text that decides when the skill fires.

bodystring required

The skill runbook as markdown: the full set of instructions an agent follows on the user's behalf.

tagsstring[]

Discovery tags surfaced when listing and searching skills. When omitted on an update, the existing tags are preserved; send an empty list to clear them.

outcomestring nullable

The business outcome this skill is meant to drive, surfaced as a discovery facet. When omitted on an update, the existing outcome is preserved; send null to clear it.

verifiersobject[] nullable

Semantic verifier references this skill invokes on agent output. Each entry names a deployed verifier by id or id@version. When omitted on an update, the existing list is preserved unchanged.

image_generatorsobject[] nullable

Image generator references for this skill. Each entry binds a local name (used in generation steps) to a generator reference. The reference is either a platform-managed quality tier (system:<tier>) or a specific deployed generator (uuid or uuid@version). When omitted on an update, the existing list is preserved unchanged.

expected_version_tokenstring uuid nullable required

Concurrency token from the latest known version, required when editing an existing skill so a stale overwrite is rejected. Omit when creating a new skill.

source'manual' | 'teach' | 'optimization' | 'description_optimization' | 'audit' nullable

Attributes the saved version to how it was produced ('manual', 'teach', 'optimization', 'description_optimization', or 'audit'); omit to leave it unset.

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.