Choose and manage skills

资料正文

Target	Use when	Command
Agent user directory	You want skills available across projects in one agent.	`skill add --agent codex`
Current project	You want a repository-specific managed copy.	`skill add --scope project`
User scope	You want the default Codex user skill directory.	`skill add --scope user`
Explicit path	You manage a custom skill directory.	`skill add --target /path/to/skills`

--scope, --agent, and --target are mutually exclusive.

tts_open_toolkit skill add --agent codex
tts_open_toolkit skill add tts-openapi-guide --scope project

tts_open_toolkit skill list --scope project --json
tts_open_toolkit skill state --scope project --json

State	Meaning
`current`	The managed copy matches the bundled version.
`outdated`	A newer managed version is available.
`modified`	Local content differs from the managed copy; review before overwriting.
`unmanaged`	The directory exists but was not installed as a managed Toolkit skill.
`unknown`	The CLI cannot determine a reliable state.

tts_open_toolkit skill add --scope project --update

💡 Use --force only when you intentionally want to overwrite local changes. Check state first.

Tell us what worked, what was unclear, or what should be added. TTS Open Toolkit Feedback Form