Skill Management

Skill Management

fkesheh

Manages reusable automation scripts with metadata, environment variables, and dependency handling in a structured ~/.skill-mcp/skills directory. Enables unified execution of Python code that combines multiple skills in a single run.

25472 views4Local (stdio)

What it does

  • List available automation skills with descriptions
  • Create and edit skill files and scripts
  • Execute scripts with automatic dependency installation
  • Manage environment variables per skill
  • Read skill details and file contents
  • Delete outdated skill files

Best for

Developers building reusable automation workflowsTeams sharing standardized scripts with metadataCreating composable multi-skill Python executions
86% test coverage with 145 passing testsUnified execution across multiple skillsAutomatic dependency management

Tools (9)

list_skills

List all available skills in the ~/.skill-mcp/skills directory with their descriptions parsed from SKILL.md frontmatter. This tool returns a lightweight overview of all installed skills, including: - Skill name and directory path - Description extracted from SKILL.md YAML frontmatter - Validation status (whether SKILL.md exists) Use this tool first to discover what skills are available before working with specific skills. Each skill is a self-contained directory that may contain scripts, data files, and a SKILL.md metadata file. Returns: List of all available skills with names, paths, and descriptions.

get_skill_details

Get comprehensive details about a specific skill including all files, executable scripts, environment variables, and metadata from SKILL.md. This tool provides complete information about a skill: - Full SKILL.md content (documentation and metadata) - All files in the skill directory with file type and size - Executable scripts with their locations - Whether Python scripts have PEP 723 inline dependencies (uv metadata) - Environment variables defined in the skill's .env file - Whether a .env file exists for this skill Use this tool to: 1. Understand what a skill does (SKILL.md content) 2. See what files and scripts are available 3. Check what environment variables are configured 4. Determine which scripts can be executed and what dependencies they have Required parameter: skill_name (the name of the skill directory) Returns: Complete skill details including files, scripts, environment variables, and SKILL.md documentation.

read_skill_file

Read and display the complete content of a specific file within a skill directory. This tool allows you to view the contents of any file in a skill. Use this to: - Read Python scripts, data files, configuration files, etc. - Examine file contents before modifying them - Check file format and structure before running scripts - View documentation or data files Parameters: - skill_name: The name of the skill directory (e.g., 'my-skill') - file_path: Relative path to the file within the skill directory (e.g., 'scripts/process.py', 'data/input.csv', 'README.md') Important: file_path is relative to the skill's root directory, not the skills directory. Use forward slashes even on Windows. Returns: The complete file content as text. If the file is very large, it will be truncated with a message indicating truncation.

create_skill_file

Create a new file within a skill directory. Automatically creates parent directories if they don't exist. This tool allows you to: - Create new Python scripts or other executable files - Create configuration files (e.g., JSON, YAML, CSV) - Create data files and documentation - Build new functionality within a skill Parameters: - skill_name: The name of the skill directory (e.g., 'my-skill') - file_path: Relative path for the new file (e.g., 'scripts/new_script.py', 'data/new_data.json') - content: The complete text content to write to the file Behavior: - Creates parent directories automatically (e.g., if 'scripts/' doesn't exist, it will be created) - Does not overwrite existing files (use update_skill_file to modify existing files) - File_path must be relative to the skill's root directory - Use forward slashes for path separators Returns: Success message with filename and character count.

update_skill_file

Update the content of an existing file in a skill directory. This tool allows you to: - Modify existing Python scripts or other files - Update configuration files or data files - Replace entire file contents - Edit documentation or metadata Parameters: - skill_name: The name of the skill directory (e.g., 'my-skill') - file_path: Relative path to the file to update (e.g., 'scripts/process.py') - content: The new complete content to write to the file (replaces entire file) Important: - This replaces the ENTIRE file content with what you provide - The file must already exist (use create_skill_file for new files) - File_path must be relative to the skill's root directory - Always provide the complete new content, not just changes Returns: Success message with filename and character count.

Alternatives