@skills: Attention is all you have
A protocol that lets AI agents fetch 'skills' on demand instead of permanently installing them
AI coding agents use procedural manuals called skills, packaged as SKILL.md files, and 56,804 are already published publicly. The dominant install model keeps every installed skill's description permanently in the system prompt, forcing them to compete for fewer than 100 reliable auto-trigger slots. This paper proposes @skills, an open protocol that separates content delivery, persistence, and auto-triggering so a skill can be read and used without ever being installed, with only a one-line trigger entry costing any prompt space.
METAL MEDIA explanatory visual
A protocol that lets AI agents fetch 'skills' on demand instead of permanently installing them
- 01Agent skills package procedural know-how as SKILL.md files, and 56,804 are publicly indexed today, yet installing one leaves its description permanently in the system prompt (the instructions the model sees on every turn), competing for fewer than a hundred reliable auto-trigger slots.
- 02The authors argue installation bundles three separable functions—content, persistence, and auto-triggering—when only auto-triggering actually needs prompt space.
- 03@skills separates these: a path (@skills:<path>) addresses and reads a skill directly for one-time use, :save vendors a copy into the project's git-tracked tree for ownership, and adding one line to a .autotrigger file (styled like .gitignore) is the only thing that costs prompt residency.
- 04The protocol needs no manifest, lockfile, or registration and leaves the SKILL.md format unchanged; it ships as an installable npm package and is implemented in the AdaL CLI and the atskills.one hub.
- 05The hub is optional—gh: and local paths resolve without it, and GitHub-hosted skills retain their gh: identity even when the hub indexes them.
What they did
- Agent skills package procedural know-how as SKILL.md files, and 56,804 are publicly indexed today, yet installing one leaves its description permanently in the system prompt (the instructions the model sees on every turn), competing for fewer than a hundred reliable auto-trigger slots.
- The authors argue installation bundles three separable functions—content, persistence, and auto-triggering—when only auto-triggering actually needs prompt space.
- @skills separates these: a path (@skills:<path>) addresses and reads a skill directly for one-time use, :save vendors a copy into the project's git-tracked tree for ownership, and adding one line to a .autotrigger file (styled like .gitignore) is the only thing that costs prompt residency.
- The protocol needs no manifest, lockfile, or registration and leaves the SKILL.md format unchanged; it ships as an installable npm package and is implemented in the AdaL CLI and the atskills.one hub.
- The hub is optional—gh: and local paths resolve without it, and GitHub-hosted skills retain their gh: identity even when the hub indexes them.
Why it matters
For developers and teams using coding agents, most of the 56,804 published skills were effectively unusable because installing everything is impractical; this protocol lets anyone reference a skill by path when needed or manage team-specific playbooks in git without wasting prompt space. It also reframes ecosystem-wide waste—like authors padding descriptions to win trigger slots, or installed skills being forgotten—as a consequence of conflating three separate concerns into one installation step.
Terms in this paper
- SKILL.md · a standardized file format holding a skill's name, one-line description, and instructions
- system prompt · the resident instruction text a model reads on every turn of a session
- auto-triggering · a skill firing automatically without the user explicitly invoking it
- manifest/lockfile · files that record installed packages and their versions for management
- MCP (Model Context Protocol) · a standard protocol for connecting AI agents to external tools and services
Original abstract (English)
There are 56,804 public agent skills today, and teams write many more privately. The dominant delivery model is installation: once installed, a skill's description remains in the system prompt, competing for fewer than 100 reliable trigger slots. This leaves the long tail with no practical path to use and forces teams' own playbooks to compete for the same scarce space. We observe that installation bundles three separable functions: content, persistence, and automatic triggering. Only the last requires prompt residency. We therefore propose @skills, an open protocol that separates them. A path addresses any skill, subtree, or collection, and reading a skill is sufficient to use it, so nothing is installed or made resident. The operation vendors a copy at the same path into a project's Git-tracked tree for adaptation and ownership. The operation adds one .gitignore-style line, the only element that costs prompt residency. A directory is a menu, making bundles ordinary directories rather than all-or-nothing units. The protocol requires no manifest, lockfile, or registration, and SKILL.md remains unchanged. @skills is additive, ships as an installable package, and turns any agent that can read files and run commands into a client through a single instruction file. Its open specification is at https://github.com/SylphAI-Inc/atskills and it is implemented in the AdaL CLI at https://adalagent.ai . Because paths address skills well but cannot find them, the protocol is paired with a free hub at https://atskills.one for corpus-wide search and ranking, repository-free hosting, private and team collections, and one-screen authoring. The hub is optional: gh: and local paths resolve without it, and indexed GitHub skills retain their gh: identities. Install less, use more.
Read on arXivLatest papers
- SWE-bench Science: Can Coding Agents Resolve Engineering Tasks in Science?AI coding agents were tested on fixing real scientific software, and even the best one failed more than half the time
- FlashPrefill V2: Block-Sparse Prefill Attention for Long-Context LLM ServingMaking sparse attention fast enough and accurate enough for real LLM serving, not just papers
- PolicyGuide: From Guarding One Action to Guiding the Whole Workflow for Policy-Compliant LLM AgentsMaking customer-service AI agents follow the whole procedure, not just avoid one bad action
- EXIMO: VLM Guided Exploration of VLA PoliciesTeaching a robot new chores without human teleoperation, by letting a chatty AI supervise it
- EnvHarness: Awakening Static Worlds for Agent LearningInstead of building new training worlds from scratch, this work adds a plug-in layer that reshapes existing ones around each agent's actual weaknesses
- Bounded Sovereignty and the Control Tax: Pricing AI Oversight When the Deployer Does Not Own the ModelCompanies that rent AI instead of owning it can only do half of AI safety oversight
- Beyond Imitation: Filtering On-Policy Distillation by Reasoning ProgressA fix for AI models that get penalized by their teacher even when they're reasoning correctly
- PersonalBench: Measuring the Authorship Gap in LLM PersonalizationAI can be prompted to write 'like someone,' but its own voice never fully disappears