mcpField
D
dot-skill

dot-skill

github.com/titanwingsAgent workflows26.1k430 installsUpdated 2w ago
Repository

About dot-skill

A Distilly skill for creating, updating, and managing reusable skills that capture how a person thinks. It routes requests to focused workflows and provides rules for storage, writing, and credential handling.

Key features

  1. 01Request-based workflow routing
  2. 02Skill creation and updates
  3. 03Workspace-based skill storage
  4. 04Controlled skill file writing
  5. 05Credential safety guidance
  6. 06Host-specific invocation guidance

Use cases

  1. 01Creating a skill from source material
  2. 02Updating an existing skill with corrections
  3. 03Listing, rolling back, or deleting generated skills
  4. 04Setting up an owner profile

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/titanwings/distilly --skill dot-skill

After installing, type/dot-skillin Claude Code to confirm it loaded.

Details

From the project README

Language: These instructions are written in English. Detect the user's language from their first message and reply to the user in that language throughout.

Skill Root: Before reading a bundled prompt or running a bundled script, resolve the absolute directory of the SKILL.md that the host actually loaded. In the instructions below, {distilly_skill_root} means that exact directory. Claude Code exposes it as ${CLAUDE_SKILL_DIR}; on every other host, use the loaded-skill path supplied by that host's discovery context. Do not assume the shell's current working directory is the Skill root, and do not guess or hard-code an install path. If the host does not expose the loaded path or more than one Distilly installation is ambiguous, ask the user to identify the active installation before running code.

Keep the shell in the user's current workspace so relative output paths such as ./skills/... remain project-local. Resolve every tools/... and prompts/... resource against {distilly_skill_root}. For example, run tools/owner_profile.py as python3 "{distilly_skill_root}/tools/owner_profile.py"; replace the placeholder with the resolved absolute path in the actual tool call.

Distilly Creator

Distilly was formerly Colleague Skill / colleague-skill. The current Skill frontmatter name and creator entrypoint are both distilly.

Route the request

Read only the flow file the request needs, then follow it.

The user saysFlow
"Set up my profile" / "Get to know me" / "Who am I to you", "distill myself", or a host's first run with no owner profile yetprompts/flows/owner.md
/distilly, "Help me create a skill", "Create a new skill", "I want to distill someone", "Make a skill for XX"prompts/flows/create.md (its Step 0 sends owner back to the owner flow)
"I have new files" / "append", "That's wrong" / "He wouldn't do that" / "He should be", /update-skill {character} {slug}, or the alias /update-colleague {slug}prompts/flows/evolve.md
"Show my skills", roll back or delete a generated skillprompts/flows/manage.md

The create flow pulls in prompts/flows/sources.md for importing material and, for celebrity, prompts/flows/celebrity_research.md. Each flow names the prompts it needs; read those when the flow gets there, not up front.

Rules for every flow

  • Storage: generated skills live under ./skills/colleague/{slug}/, ./skills/relationship/{slug}/ or ./skills/celebrity/{slug}/ in the user's workspace. For a global path, pass --base-dir with that family's storage root.
  • Writes: create and update generated skills only through tools/skill_writer.py; never hand-build or hand-edit their files.
  • Credentials: App Secrets, access or refresh tokens, Bot Tokens and OAuth codes never enter the conversation. Never ask for them; the user runs a collector's --setup / --login in their own terminal. prompts/flows/sources.md has the details.

Compatible hosts

Claude Code, OpenClaw, Hermes, Codex, DeepSeek Harness, Pi coding agent, Grok Build and OpenCode. Invoke with /distilly in Claude Code, Hermes, DeepSeek Harness and Grok Build; /distilly or /skill distilly in OpenClaw; $distilly or /skills in Codex; /skill:distilly in Pi. OpenCode loads Skills natively and has no dedicated command. Grok Bot cannot import this directory directly; do not present this repository as a Grok Bot install.

Comments

Markdown supported