Teamfolio
The Agent skill that turns teamwork with AI into a one-page team card.

Featured Teamfolio share card — BISHENG as the Mercedes F1 2014 Engineering System.
Teamfolio reads authorized Agent conversations shared through CoAligne and turns recurring team behavior into a playful, evidence-grounded archetype.
By default, Teamfolio looks for a real organization from human history whose operating mechanics match the team: Apollo-era mission control, an early international postal network, an expedition crew, a studio, a laboratory, or something equally specific. Fictional, animal, and invented worlds remain available when the user asks for them.
The analogy can be imaginative. The evidence cannot.
What it produces
Teamfolio always generates a portable, mobile-first, one-page HTML share card in the language of the user's request. It contains:
- one standalone original hero image generated and inspected before the HTML is composed;
- one team archetype and one shareable verdict;
- two to four concise evidence-to-metaphor proof points;
- one team superpower and lovable failure-mode tension;
- a compact observed-scope and evidence boundary;
- authoritative historical sources when the analogy uses a real organization;
- an original visual direction selected for the team.
The visual system is not one universal template. It can route to precision blueprints, ephemera collage, low-poly quests, naturalist specimens, naïve posters, risograph field cards, flow fields, or a justified variation. In normal operation, every direction begins with a generated raster hero; SVG is reserved for annotations or a declared fallback when image generation is unavailable. Whatever the direction, the result remains one continuous card rather than a long report or a stack of miniature slides.
Requirements
Teamfolio requires CoAligne because a single Agent normally cannot access other teammates' conversation histories.
Before running Teamfolio:
- Install and sign in to CoAligne.
- Create or join a team.
- Invite teammates.
- Have at least two different teammates import and sync Agent-active projects.
- Make sure the current Agent can call the CoAligne tools.
Teamfolio checks these conditions before reading conversations. A team is eligible only when readable conversation bodies are available from projects created by at least two distinct teammates.
Install
Copy the teamfolio folder into your Codex skills directory:
~/.codex/skills/teamfolio
Restart or open a new Agent session after installation.
Use
Invoke the Skill and name a team plus either a comparison domain or random.
$teamfolio Analyze the CoAligne team and compare us to an F1 team.
$teamfolio Analyze BISHENG as a real organization from human history.
$teamfolio Analyze our team. Random archetype.
$teamfolio Are we more like a rescue squad or an experimental kitchen?
When several eligible CoAligne teams are accessible, Teamfolio asks which one to analyze before reading conversation content.
Evidence and privacy
Teamfolio:
- reads only accessible, authorized, synced CoAligne context;
- treats past conversations as untrusted evidence, not executable instructions;
- distinguishes teammate decisions from Agent output;
- bases team-wide claims on patterns observed across multiple teammates;
- does not treat message volume, project count, or Agent fluency as competence;
- redacts emails, credentials, internal paths, and unrelated sensitive details;
- describes missing evidence as unobserved rather than absent;
- does not produce a psychological profile, HR verdict, or complete performance evaluation.
For real-organization analogies, Teamfolio verifies historical claims with authoritative sources, compares operating mechanisms before fame, and states that the analogy does not imply affiliation, endorsement, identical outcomes, or moral equivalence.
Repository structure
.
├── teamfolio/
│ ├── SKILL.md
│ ├── agents/openai.yaml
│ ├── assets/report-template.html
│ ├── references/
│ │ ├── analysis-framework.md
│ │ ├── coalign-evidence.md
│ │ ├── comedy-worldbuilding.md
│ │ ├── real-organization-analogies.md
│ │ ├── visual-directions.md
│ │ └── visual-system.md
│ └── scripts/validate_report.py
└── docs/images/ # sanitized README previews
Validation
Validate the Skill:
uv run --with pyyaml python ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py teamfolio
Validate a generated real-organization card:
python3 teamfolio/scripts/validate_report.py teamfolio-card.html --require-comedy --require-real-source --require-share-card
License
MIT