Discover and add a Skill

When to use this

You have the application installed and want to manage an existing Skill. A Skill is a complete directory containing SKILL.md and any supporting resources. Discover can show candidates from GitHub, Agent user directories, and local projects. Project directories are discovery sources, not destinations where the product applies Skills.

Steps

1. Open Discover, choose a source, and review its Skill candidates.
2. Check the candidate's name, description, and source to confirm that it is the complete Skill you intend to manage.
3. Choose to add the candidate and complete the confirmation. The product copies the selected directory into its managed library and keeps the selected source association.
4. If a managed Skill with the same name has different content, resolve the name conflict first. The product does not silently merge or overwrite either Skill. If the source cannot be read, fix access to the source before reviewing the candidate again.

Result and limits

The added Skill appears in the managed library and can then be applied to an Agent from the Skills page. Discovery and adding do not move, rename, or write back to the original source. They do not apply the Skill to an Agent automatically.

When a source changes later, refreshing the source, checking for changes, and syncing managed content are separate actions. The product can check for changes, but updating the managed copy requires your explicit confirmation. It does not sync content in the background.