| name | portable-agents |
|---|---|
| description | Build portable agents for AI-only, human-only, or collaborative AI-human workflows. Repository demonstrating self-sufficient AI agents that work anywhere. |
Build portable agents for AI-only, human-only, or collaborative AI-human workflows.
Portable agents are self-sufficient—they carry everything they need: knowledge bundled as skills, initialization patterns that adapt to their environment, and workspace protocols that define safe boundaries. The goal: build once, run anywhere.
This repository enables three modes of agent and skill creation:
- AI-only — Create autonomous AI capabilities (SKILL.md or AGENT.md only)
- Human-only — Create human documentation and guides (README.md only)
- Collaborative — Enable mutual awareness where humans and AI work as peers (both file types)
The collaborative mode is the primary focus and intent. It's where humans and AI agents each have their own documentation while maintaining mutual awareness. Humans read README.md files and guides. AI agents read SKILL.md and AGENT.md files. The portable-agents directory showcases this approach, providing both human learning materials and an AI co-author agent that helps you create your own portable agents.
All three modes are valid. Choose based on your needs.
This repository contains:
- portable-agents/ — Build portable agents with AI assistance (main deliverable)
- agents/ — Agent specification (AGENT.md format)
- agentskills/ — Skill specification (SKILL.md format)
- workspace/ — Workspace access protocols
→ portable-agents/ — Start here to create your first portable agent
The portable-agents directory includes:
- Human documentation and guides
- AI co-author agent to help you build
- Complete methodology for design, planning, and implementation
