Skip to content
Guide by Knoveya

Install and verify a reusable agent skill

Knoveya

Install a reviewed skill in the intended agent's supported location and verify it is actually discovered.

Goal

Install a reviewed skill in the intended agent's supported location and verify it is actually discovered.

Step-by-step

  1. Check current agent documentation.
  2. inspect the skill's scope and permissions.
  3. create an isolated example folder.
  4. test a matching request.

Worked scenario

Create a Codex skill folder containing a complete SKILL.md, then validate discovery.

Write down the current behavior, the intended change, and the evidence you would need before deciding it worked. Use synthetic or anonymized material for exploration.

Acceptance check

Installation is deliberate and does not overwrite an existing skill.

Common failure

A convincing artifact can hide untested assumptions. Keep an explicit list of unknowns and test the highest-consequence transition before expanding the work.

Next step

Apply the guide to one bounded task, review the evidence, and adjust the approach. The linked reference is a separate publication; this guide is Knoveya's independent treatment of the topic.