Ground Truth.
AI, checked against the source.

News · 2026-07-24

Agent skills quietly became a package format - and GitHub is warning about what that means

Five agent-skill projects gained a combined 6,634 GitHub stars in a single day on July 24, and they are not five competing frameworks. They are a convergence on one shape: a folder holding a SKILL.md file with YAML metadata, a Markdown procedure, and optional scripts. Alongside the land rush, GitHub's own documentation now warns that third-party skills may contain prompt injections, hidden instructions, or malicious scripts, and tells users to preview them before installing.

Key facts

The quiet part of this story is that a file format won. Anthropic introduced Skills in October 2025 and later published Agent Skills as an open standard; the spec requires only a SKILL.md carrying a name and a description, with optional compatibility declarations, allowed-tools lists, scripts, references, and assets loaded progressively rather than all at once. GitHub then implemented the same structure, supporting .github/skills, .claude/skills, and .agents/skills directories, plus gh skill commands to search, preview, install, update, validate, and publish. When the largest code host adopts a rival lab's format verbatim, that is the strongest corroboration a standard can get.

What is spreading through it is more varied than "prompt libraries". Matt Pocock's skills is a deliberately small set of engineering workflows - design review, issue triage, test-driven development, spec generation - and its author explicitly contrasts this with frameworks that want to own your whole process. Composio's awesome-claude-skills is a directory rather than a runtime, pitching a split where a gateway supplies authenticated actions and a skill supplies the workflow; its claimed thousand-plus catalogue is a maintainer count, not an audited one. ego-lite, a macOS browser built for humans and agents to browse in parallel, ships a skill that defines a Playwright-like JavaScript surface - a product integration contract, not a prompt. OmniRoute is a local multi-provider AI gateway whose skills tree is really operational documentation for configuring the software itself. And RuView is a Wi-Fi sensing project that exposes hardware setup and training as skills.

That spread is the point. The format is being used as a documentation layer, a control plane, an integration contract, and a workflow library, all at once. Think of SKILL.md less as a prompt template and more as what package.json was for JavaScript: a boring envelope whose value is that everything agrees on it.

Which is exactly why the security warning matters. A package format is a distribution surface. Once thousands of people install folders written by strangers into a directory their coding agent reads automatically, you have reinvented dependency supply-chain risk - except the payload is natural-language instructions that a model will follow, plus scripts it may run. That is prompt injection with a distribution channel attached. GitHub does not soften it: its documentation states plainly that third-party skills may contain prompt injections, hidden instructions, or malicious scripts.

The failure mode is not hypothetical in kind. A skill's whole design is progressive disclosure - the agent reads the description first, then pulls in the fuller procedure and bundled files when it decides the skill is relevant. That means the text an agent eventually loads is not necessarily the text a human previewed at install time, and the decision to load it is the model's. The research community has been circling this class of problem for a while; NeurIPS went as far as banning prompt injection in review submissions after finding hidden instructions aimed at AI reviewers.

The honest limit on the hype: this is not yet a universal agent plug-in API. The portable piece is the envelope - a discoverable name and description plus instructions and materials. The non-portable pieces are the ones that decide behaviour: which tools are available, what the permission model allows, where the package installs, whether activation is automatic or manual, and whether the host treats the folder as a skill, a prompt, or a rules file. RuView demonstrates the gap directly: its Codex support is a mirror of slash prompts plus an AGENTS.md, not the same native bundle. The format travels further than the runtime does.

The most telling adoption signal is not the star count, which measures attention rather than maturity. It is a discussion thread on Pocock's repo where users are asking for a canonical chain - idea to requirements to planning to implementation - instead of a pile of files. People are trying to compose these units into an actual engineering process. That is when a format stops being a curiosity and starts being infrastructure, and it is also precisely when its security properties stop being optional.


Primary source, verified: read the paper →

Key questions

What is an agent skill, technically?

It is a folder containing a SKILL.md file with YAML metadata and a Markdown procedure, plus optional scripts, references, and assets. The official specification requires only a name and a description; everything else - compatibility, allowed tools, bundled code - is optional.

Why is GitHub warning about installing skills?

Because a skill is executable workflow policy, not just documentation. GitHub's own agent-skills documentation tells users that third-party skills may contain prompt injections, hidden instructions, or malicious scripts, and advises previewing them before installation.

Do skills actually work across different AI coding agents?

The file format travels; the runtime does not. Tools, permission models, install locations, and whether activation is automatic or manual all differ per host. The RuView project illustrates the gap: its Codex support is a mirror of slash prompts plus an AGENTS.md file, not the same native skills bundle.
Cite this

APA

Ground Truth. (2026, July 24). Agent skills quietly became a package format - and GitHub is warning about what that means. Ground Truth. https://groundtruth.day/news/agent-skills-become-a-package-format.html

BibTeX

@misc{groundtruth:agent-skills-become-a-package-format,
  title  = {Agent skills quietly became a package format - and GitHub is warning about what that means},
  author = {{Ground Truth}},
  year   = {2026},
  month  = {jul},
  url    = {https://groundtruth.day/news/agent-skills-become-a-package-format.html}
}

Topics: cybersecurity · prompt-injection · supply-chain · ai-security · agents · developer-tools · open-source · standards

Comments are replies to this story on Bluesky — reply with any Bluesky account to join in.