skills_get_details
Retrieve documentation and file structure for installed skills to understand their functionality and usage instructions.
Instructions
Read the instruction manual (SKILL.md) and file structure of a locally installed skill. Use this to learn how to use a skill after installing it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the installed skill |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/skills_mcp/server.py:65-87 (handler)The handler function for the 'skills_get_details' tool, including registration via @mcp.tool() decorator and Pydantic schema via Field. Formats output from local.get_details.
@mcp.tool() def skills_get_details( name: str = Field(description="Name of the installed skill") ) -> str: """ Read the instruction manual (SKILL.md) and file structure of a locally installed skill. Use this to learn how to use a skill after installing it. """ try: details = local.get_details(name) return f"""# Skill: {name} Path: {details['path']} ## File Structure ``` {details['tree']} ``` ## Instructions {details['instruction']} """ except Exception as e: return f"Error getting details: {str(e)}" - src/skills_mcp/local.py:31-44 (helper)Core helper function that implements the logic to retrieve skill details: path, file tree, and SKILL.md content.
def get_details(name: str) -> Dict[str, str]: target_dir = config.root_dir / name if not target_dir.exists(): raise FileNotFoundError(f"Skill '{name}' is not installed locally.") skill_md = target_dir / "SKILL.md" if not skill_md.exists(): raise FileNotFoundError(f"Corrupted skill '{name}': SKILL.md missing.") return { "path": str(target_dir), "tree": generate_tree(target_dir), "instruction": skill_md.read_text(encoding="utf-8") } - src/skills_mcp/utils.py:20-47 (helper)Supporting utility to generate a filtered visual file tree of the skill directory, used by get_details.
def generate_tree(root_path: Path) -> str: """Generates a visual file tree string, filtering out noise.""" output = [] # Walk the directory for dirpath, dirnames, filenames in os.walk(root_path): # 1. In-place filtering of directories to prevent recursion into ignored dirs dirnames[:] = [d for d in dirnames if d not in IGNORED_DIRS and not d.startswith(".")] rel_path = Path(dirpath).relative_to(root_path) if rel_path == Path("."): level = 0 else: level = len(rel_path.parts) indent = " " * (level - 1) output.append(f"{indent}- {rel_path.name}/") sub_indent = " " * level for f in sorted(filenames): if f in IGNORED_FILES or f.startswith("."): continue if any(f.endswith(ext) for ext in IGNORED_EXTENSIONS): continue output.append(f"{sub_indent}- {f}") return "\n".join(output)