Skills MCP

Instructions

Implementation Reference

• src/skills_mcp/server.py:37-52 (handler)

  The main handler function for the 'skills_list' tool, decorated with @mcp.tool(). It retrieves locally installed skills using local.get_installed_skills() and formats them into a readable list or error message.

  @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)

  Supporting helper function called by skills_list handler. Scans the configured root directory for subdirectories containing 'SKILL.md' files and returns a list of dicts with skill 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