Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Teamfolio

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

BISHENG Teamfolio English share card: Mercedes F1 2014 Engineering System

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:

  1. Install and sign in to CoAligne.
  2. Create or join a team.
  3. Invite teammates.
  4. Have at least two different teammates import and sync Agent-active projects.
  5. 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

About

The skill that turns your teamwork with AI into a team portfolio

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages