team-apilisted
Install: claude install-skill Habitat-Thinking/ai-literacy-superpowers
# Team API
Generate or update a Team Topologies Team API document enriched with
AI literacy portfolio assessment data. The Team API is a document
that describes a team's capabilities, communication preferences, and
service offerings — adding AI literacy data makes the team's
engineering maturity visible to the rest of the organisation.
This skill works in two modes:
- **Update mode**: reads an existing Team API document and adds or
refreshes the AI literacy section using the latest portfolio
assessment data
- **Template mode**: generates a new Team API document from the
template in `references/team-api-template.md`, populated with
portfolio assessment data
## Input
The skill needs:
- **Portfolio assessment file** — the most recent
`assessments/*-portfolio-assessment.md`. If none exists, tell the
user to run `/portfolio-assess` first.
- **Existing Team API file** (optional) — if the user provides a path
to an existing Team API document, update it. If not, generate from
the template.
- **Team directory** (optional) — where to write the output. Defaults
to the current directory.
## Process
### Step 1: Find Portfolio Assessment Data
```bash
ls assessments/*-portfolio-assessment.md 2>/dev/null | sort | tail -1
```
If no file exists, stop and suggest running `/portfolio-assess`.
Read the most recent portfolio assessment and extract:
- Portfolio median level
- Assessment coverage percentage
- Repo detail table (each repo with level and discipline scores