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#

    LimitValue
    ZIP size, website upload50 MB
    Files per package1,000 (website upload)
    Skills per pack50
    Upload from your agent100 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 receivesEvery 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 (__MACOSX folders and ._ files) are ignored.