Create a skill
- Open Agents → Skills and choose New skill.
- Choose the Scope. Start with Only me, test the skill, and promote it once it works. You can create skills only in scopes where you can publish.
- Choose a Source:
- Write SKILL.md: its YAML frontmatter needs a
name(lowercase letters, digits and hyphens) and adescription. - Upload ZIP: a package with
SKILL.mdat its root or inside one folder, up to 8 MiB. Supporting files such asscripts/,references/andassets/are kept as uploaded.
- Write SKILL.md: its YAML frontmatter needs a
- Optionally add a Title for the dashboard and comma-separated Tags, then choose Create skill.
Checks and versions
Every version is immutable. Choose New version to publish a change; leave Version number empty to bump the patch. Each version runs static checks, shown under Checks:
Fork copies a skill into your own scope and records where it came from. Deprecate and
Archive retire a skill without deleting it; archived skills are not delivered to agents.
Delete removes every version, placement and request.
Share a skill with more people
A skill reaches people through placements. Each placement binds the skill to a scope with a mode and a version policy:- Pinned version keeps the placement on one version until someone changes it, which is also how you roll back.
- Follow new versions moves the placement when a new version is published. Where the publisher has no authority, a review is requested instead.
Review requests
Reviews lists the promotion and update requests you made or can decide. Reviewers see the version, the requester’s reason and usage before choosing Approve or Reject. Requesters can Withdraw a pending request. Owners and Org admins set the organization’s Policy:- Skills with scripts: Never share, Share after independent review (the default), or Share like any other skill.
- Requesters with authority can approve their own requests: turn it off to require an independent reviewer for every promotion.
What your agents receive
What your agents receive shows the skills resolved for you in the selected project: those placed in the organization, the project, your teams and your personal scope. When two different skills share a name, Required wins, then the narrower scope (you, project, team, organization). Equal precedence is shown as a Conflict and both are kept. Agents connected to the Aixy MCP endpoint load these skills with theaixy_skills helper. For an
agent without it, choose Download for local agents and unzip the file into the agent’s skills
folder. The download is a snapshot: it does not update or remove local copies later.
Each skill shows its loads, the members who loaded it, and the last load over the past 30 days.
Usage records which skill and version were loaded, never the skill text, prompts or arguments.
Who can do what
Skills that only one member owns are visible only to that member, including to administrators.
They are removed with the member’s membership. Skills owned by a scope belong to that scope.