Agent skill
deaddrop skill installs an Agent Skill that
teaches AI coding agents how to use deaddrop: serving, fetching, resets, and
setting up a config file step by step. The skill is built into the binary, so
it always matches the version you have installed, and it includes the full
config reference.
deaddrop skill install # asks where, and for which agentsdeaddrop skill install --global --harness claude,codex # for your user, in every projectdeaddrop skill install --project --all # only this repository; commit it to sharedeaddrop skill status # where it's installed, and if it's currentdeaddrop skill uninstall --global --alldeaddrop skill show # print SKILL.mdWhat gets installed
Section titled “What gets installed”A deaddrop folder in each agent’s skills directory:
Directorydeaddrop/
- SKILL.md how to use deaddrop
Directoryreferences/
- config.md every config setting, generated from this version’s template
Where it goes
Section titled “Where it goes”--harness |
Global (--global) |
Project (--project) |
|---|---|---|
claude (Claude Code) |
~/.claude/skills/ |
.claude/skills/ |
codex (OpenAI Codex) |
~/.agents/skills/ |
.agents/skills/ |
copilot (GitHub Copilot) |
~/.copilot/skills/ |
.github/skills/ |
agents (shared Agent Skills location, also read by the Copilot CLI and others) |
~/.agents/skills/ |
.agents/skills/ |
- Global is for your user, in every project.
- Project is the enclosing git repository, or the current directory.
--dirpicks another. Commit the skill to share it with your team. --harnesstakes a comma-separated list (or repeat it).--allmeans every agent.
On a terminal, install and uninstall ask for the scope and agents you left
out, pre-selecting the agents they find. Without a terminal they fail
instead, so scripts must pass --global/--project and --harness/--all.
Subcommands
Section titled “Subcommands”| Subcommand | Meaning |
|---|---|
skill install |
Install or update the skill. --force replaces a deaddrop skill deaddrop didn’t write. |
skill uninstall |
Remove the skill. --force removes one deaddrop didn’t write. |
skill status |
Where the skill is installed, for every agent and both scopes, and whether it’s current. Takes --dir. |
skill show |
Print SKILL.md to stdout. |
Updating
Section titled “Updating”Run deaddrop skill install again after upgrading deaddrop, with the same
scope and agents. skill status tells you if an installed copy is out of
date.
Installing from the repository
Section titled “Installing from the repository”The skill is also committed at
skills/deaddrop/
in the deaddrop repository, so tools that install skills straight from a
GitHub repository can use it too.