Skip to content

Call a skill or a command

From a session’s input box you can pick from the skills and commands that session can actually call. You do not need to remember their names: insert one while reading its description.

What you do What the agent does
Pick a skill or a command from the list, add arguments, send Takes it like any prompt, and runs that skill or command
Pick a skill written for another agent Gets “read that file and follow its instructions”, reads it and follows it

The button to the left of the input box opens the list. It shows the trigger character.

Agent Button Typed at the head of the input box
One with a trigger character / or $ The same character. The full-width / and $ a Japanese IME produces are accepted too
One without ✦ None (open it from the button)
The list opened from the "/" button to the left of the input box. /handoff and /proofread are listed with their descriptions, followed by "Show 8 more bundled with the CLI"
  • Each entry carries its description, an argument hint, and where it came from: user, CLI or shared
  • The ones bundled with the CLI are folded away; “Show N more bundled with the CLI” opens them
  • Which kinds offer the list is in the “Skill / command picker” row of the Agents reference

Picking one only inserts it into the input box; nothing is sent. Add the arguments, then send.

Key What it does
↑↓ Move
Enter (or Tab) Insert into the input box
Esc Close the list

Skills written for another agent and left in the repository are listed too. Picking one inserts “Read ‹file› and follow that skill’s instructions.”, so even an agent with no skill mechanism of its own can use the content.

Skills an agent wrote itself (folder names starting with afa-) can be archived by the Agent when nobody has used them for 30 days. This only happens when the skill curator is switched on, and it never touches skills you wrote. An archived skill is moved to .archive/ inside the skills folder; nothing is deleted.

To get one back, ask any session: “list the archived skills” and then “restore afa-foo”. The session uses the skill_restore tool:

You ask What happens
List Each archived skill is shown with its name, when it was archived and the skills folder it came from
Restore The skill moves back under its old name and counts as just used, so the next pass does not archive it again at once

Restore only touches your own skills folders. It refuses, and changes nothing, when a skill with the same name already exists: rename or remove that one first, then ask again.

“No skills/commands for this session” means nothing can be called from that session. Add your own skills in ⚙ Settings → “Skills”.

That kind does not offer the list. Check the “Skill / command picker” row of the Agents reference.