tentacle-skills-washing

Adapt downloaded Python and TypeScript skills to vault runtime conventions.

4|1|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/tentacle-pro/skills --skill tentacle-skills-washing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tentacle-skills-washing
Source: https://github.com/tentacle-pro/skills/tree/main/tentacle-skills-washing
Command: npx skills add https://github.com/tentacle-pro/skills --skill tentacle-skills-washing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill fixes and adapts downloaded or third-party Agent Skills so they run reliably in this vault's runtime and folder conventions by correcting runners, dependencies, paths, and documentation mismatches.

Core Features & Use Cases

  • Runtime normalization: Convert instructions and execution commands to use the vault's uv runner for Python and bun for TypeScript.
  • Dependency and packaging fixes: Add PEP 723 inline metadata for standalone Python scripts and ensure a local package.json plus bun-managed dependencies for TypeScript skills.
  • Path and artefact containment: Replace absolute or author-specific paths with vault-root-relative paths and ensure all logs or temporary files remain inside the skill directory; useful when installing community skills or repairing skills that error on execution.

Quick Start

Ask the assistant to "wash this skill at .agents/skills/my-skill/" to perform the adaptation and provide a smoke test instruction.

Frequently Asked Questions about tentacle-skills-washing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I adapt third-party Python and TypeScript skills to run in a different environment?

To adapt third-party Python and TypeScript skills, you must update runtime commands, dependencies, and file paths. This process converts Python scripts to use uv with PEP 723 inline metadata and TypeScript to use bun with a local package.json for correct execution.

Why do downloaded Agent Skills fail to execute due to file path errors?

Downloaded Agent Skills fail due to absolute or author-specific file paths that do not match your local environment. Repairing these skills requires replacing absolute paths with vault-root-relative references and confining all artefacts to the skill directory.

How do I convert Python scripts to use uv and PEP 723 inline metadata?

Converting Python scripts to use uv involves injecting PEP 723 inline metadata for standalone dependency management. This ensures the script runs correctly within the vault's uv runtime without requiring separate virtual environment setups.

Does this skill washing process work for both Python and TypeScript skills?

Yes, skill washing works for both Python and TypeScript skills by normalizing their runtimes. It applies uv for Python scripts and bun with a local package.json for TypeScript, ensuring both languages execute correctly inside the target vault.

What are the limitations when repairing community skills for local vault execution?

A key limitation when repairing community skills is ensuring all temporary files and logs remain confined inside the skill directory. You must also reconcile documentation mismatches and update smoke test instructions to verify the adapted skill works within your specific vault structure.