Agent Portfolio Format Specification

1. Overview

An Agent Portfolio is a downloadable JSON package that bundles a complete, tested AI agent configuration ready for import into a target AI agent platform (e.g. OpenClaw, n8n, LangChain-based apps).

Each portfolio must be:

• Complete — contains everything needed to recreate the agent's behavior
• Tested — includes at least one test case demonstrating it works
• Self-contained — no hidden dependencies or undocumented API calls
• Platform-targeted — declares which platform(s) it targets

2. File Structure

A portfolio lives in a single directory with this structure:

my-portfolio/
├── portfolio.json          # Required: all metadata and config
├── system-prompt.md        # Required: the agent's system prompt
├── tool-definitions.json    # Optional: tool/API definitions
├── test-cases.json         # Required: at least 1 test case
├── deployment-guide.md     # Required: platform-specific import steps
└── assets/                 # Optional: icons, screenshots
    ├── icon.png
    └── screenshots/
        └── demo.gif

3. portfolio.json Schema

See the full schema documentation on the left navigation.

7. Quality Bar

To be listed on Promptfolio, a portfolio must pass:

9. Platform Identifiers