Package your skill
Upload one ZIP. Agensi finds every SKILL.md in it, at any depth: one makes a skill, two or more make a skill pack.
The SKILL.md file#
Name it SKILL.md and start it with frontmatter. The top SKILL.md must have a name. Give every SKILL.md a description as well: in a pack, the buyer's agent picks a skill by its name and description.
markdown
---
name: GEO audit
description: Scores a site's visibility in AI search and lists fixes in priority order.
---
# GEO audit
Instructions for the agent go here.
The upload form also reads summary, version, tags, keywords, use_cases and docs_url from the frontmatter to fill in your listing.
Layouts that work#
text
geo-audit.zip
├── SKILL.md
├── references/scoring-rubric.md
├── scripts/crawl.py
└── templates/report.md
text
seo-pack.zip
├── README.md "# SEO Pack" becomes the pack name
├── shared/brand-voice.md available to every skill in the pack
└── skills/
├── audit/SKILL.md
└── report/SKILL.md
One top folder around everything is fine. A pack doesn't need a SKILL.md at the root; if it has one, that's just one of the included skills. When the agent loads a skill from a pack, it gets that SKILL.md, the other files in its folder, and the shared files outside every skill folder.
What you can include#
- Text and code: references, scripts, templates, configs, .env.example. Scripts run in the buyer's session exactly as shipped: the agent writes each one unchanged to a temporary file, runs it and removes it.
- Images and PDFs: allowed, but agents can't read them, because Agensi delivers text files only. Put anything the agent needs in text.
- Executables: fail the File types check (exe, dll, so, dylib, bin, app, dmg, msi, deb, rpm, wasm, class, jar, war).
Limits#
| Limit | Value |
|---|---|
| ZIP size, website upload | 50 MB |
| Files per package | 1,000 (website upload) |
| Skills per pack | 50 |
| Upload from your agent | 100 files, 5 MB, text only |
| Bundled dependencies (node_modules, site-packages, Python virtual environments) | Not allowed |
| Removed automatically on upload | .git folders, Python caches, .DS_Store |
| What a buyer's agent receives | Every SKILL.md, plus up to 200 other text files, within 6 million characters per listing |
Before you upload#
- Keep the logic in each script under 20 KB so it stays easy to review; split larger logic into several scripts.
- Each script runs on its own from a temporary file, so it can't read other files in your package. Put any data a script needs, such as lookup tables, schemas or prompt lists, inside the script itself. That data doesn't count toward the 20 KB guideline.
- Test the skill with your own agent first. Agensi only serves a listing once it's live.
- Names are unique across Agensi, and a package identical to another creator's is blocked.
- If the upload says the ZIP is damaged, re-create it. Mac system files (
__MACOSXfolders and._files) are ignored.