skills_list
Display all external Agent Skills installed in your local environment to identify available capabilities and complement built-in tools.
Instructions
List all external Agent Skills currently installed in the local environment. Call this tool when the user asks 'what skills do I have' or 'show my skills', to complement your knowledge of built-in tools.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/skills_mcp/server.py:37-52 (handler)The main handler function for the 'skills_list' tool. It retrieves installed skills using local.get_installed_skills(), formats them into a readable list, and handles errors gracefully.@mcp.tool() def skills_list() -> str: """ List all external Agent Skills currently installed in the local environment. Call this tool when the user asks 'what skills do I have' or 'show my skills', to complement your knowledge of built-in tools. """ try: skills = local.get_installed_skills() if not skills: return "No skills installed locally." output = ["Installed Skills:"] for s in skills: output.append(f"- {s['name']} ({s['path']})") return "\n".join(output) except Exception as e: return f"Error listing skills: {str(e)}"
- src/skills_mcp/local.py:14-26 (helper)Helper function that scans the configured root directory for subdirectories containing 'SKILL.md' files, identifying them as installed skills, and returns a list of dictionaries with name and path.def get_installed_skills() -> List[Dict[str, str]]: """List local skills.""" skills = [] if not config.root_dir.exists(): return [] for item in config.root_dir.iterdir(): if item.is_dir() and (item / "SKILL.md").exists(): skills.append({ "name": item.name, "path": str(item) }) return skills
- src/skills_mcp/server.py:37-37 (registration)Registers the skills_list function as an MCP tool using the @mcp.tool() decorator on the FastMCP instance.@mcp.tool()