MCP2Skill logoMCP2Skill Docs
MCP2Skill logoMCP2Skill Docs
HomepageMCP2Skill User Manual

Manage Installed Skills

Read the Skills page, browse installed Skills per AI Agent, preview Skill files, locate them in Finder, and delete the ones you no longer need.

The Skills page is used to view the contents of the skill directories that MCP2Skill has recognized. What is shown here are "Skills that already exist in the AI Agent target directories," not drafts waiting to be generated.

How to Read the Skills Page

The page is usually split into two panels:

  • The left side is the AI Agent list
  • The right side is the Skills discovered under that AI Agent

If an AI Agent directory is unavailable, the page reflects that state as well.

The AI Agent List on the Left

The left-hand list is used to switch the viewing scope. Here you can quickly determine:

  • Which AI Agents are currently configured
  • Which directories are available
  • Roughly how many Skills each AI Agent has

If you have just bound a Skill but the target AI Agent does not appear here, go to the Settings page first and confirm the AI Agent configuration exists.

The Skill List on the Right

After selecting an AI Agent, the right side shows the Skills under that directory. Common information includes:

  • Skill name
  • Directory name
  • Description

If you use a clear naming convention, ongoing management becomes much easier.

Preview Skill Files

After clicking View, you can preview the following in a dialog:

  • SKILL.md
  • Other text files in the directory

This step is useful for confirming:

  • Whether the generated result is correct
  • Whether the directory structure is complete
  • Whether the text content matches your expectations

Locate a Skill in Finder

If you want to inspect the actual files directly, you can use an entry point such as "Reveal in Finder."

This is suitable for:

  • Manually adjusting the directory contents
  • Backing up or copying a Skill
  • Confirming exactly where it was written

Managed vs. External Groups

The list splits Skills into two groups:

  • Managed: generated by a binding, carries a source badge, and follows the source for automatic updates
  • External: directories not managed by this app, including ones you placed manually and ones written by the old one-shot install

Delete an Installed Skill

The current version supports deleting a Skill directory directly from the Skills page. Before deleting, we recommend confirming:

  • Whether the Skill is still actively in use
  • Whether you have a backup
  • Whether you simply want to regenerate rather than delete it entirely

After deletion, refresh the list to see the result.

Note: after you delete a Managed Skill, the next sync will regenerate it. To remove it for good, go to the Skills > Bindings page and unbind the corresponding binding.

What to Check First When a Skill Is Not Visible

Check the following items first:

  • Whether the corresponding AI Agent has been configured
  • Whether the Skill directory path is accessible
  • Whether the Skill has actually been written into that directory
  • Whether SKILL.md exists in the directory

If all of the above look fine, go back to the generation workflow and troubleshoot from there.

Related Chapters

  • To generate or bind a Skill first: see Generate Skills
  • To configure AI Agent directories: see General and MCP Settings
  • To troubleshoot directory recognition issues: see FAQ and Troubleshooting

Table of Contents

How to Read the Skills Page
The AI Agent List on the Left
The Skill List on the Right
Preview Skill Files
Locate a Skill in Finder
Managed vs. External Groups
Delete an Installed Skill
What to Check First When a Skill Is Not Visible
Related Chapters