A skill or competency within a team
A skill is a specific capabilityCapabilityStrategyAn ability that enables value deliveryView reference → that a person or a team holds: TypeScript, user interviewing, incidentIncidentDevOps & PlatformA production incidentView reference → command, financial modelling. It is the unit you reason about when you ask whether a team can actually do the work in front of it, and whether you should grow that capability, hire it, or buy it. A skill is held, where a role is assigned, and the gap between the two is where most delivery riskRiskComplianceA risk to the product or businessView reference → hides.
Treating capability as a named, mappable thing produced the skills matrix: a grid of people against competencies, scored by proficiency, used to spot coverage and single points of failure. The matrix makes a quiet but important claim, that capability is an attribute of an individual or group, separate from the role they happen to be assigned and the title they happen to hold.
The most influential shape for an individual's skill profile is the T. The "T-shaped" idea began as internal McKinsey language for consultants in the 1980s, was articulated publicly by David Guest in a 1991 Independent article on the "Renaissance Man of computing", and reached the product and design world when IDEO's Tim Brown described hiring T-shaped people around 2010 (Wikipedia). The vertical bar is depth in one discipline; the horizontal bar is enough breadth to collaborate across others. A team of pure specialists ("I-shaped") bottlenecks on hand-offs; a team of pure generalists lacks anyone who can go deep.
Where the skill concept earns its keep operationally is the build-versus-hire-versus-buy decisionDecisionStrategyA recorded decision with context, rationale, and consequencesView reference →. A skills matrix that shows a gap, say, no one on the team can do data engineering, turns an abstract worry into a choice with three named options: grow the capability internally, hire someone who has it, or contract it out. The matrix dates the gap and lets you watch it close.
A team of six is asked to ship a usage-based billing system. The skills matrix shows deep coverage in frontend and backend, one person at intermediate data engineering, and nobody with payments-domain experience. That is two gaps with different answers. Data engineering is adjacent to skills the team already has, so they grow it: the intermediate engineer pairs with a contractor for a quarter and the matrix moves her to proficient. Payments domain knowledge is far from anything they hold and the deadline is fixed, so they hire it. Six months later the matrix shows the data-engineering gap closed internally and a new permanent hire carrying the payments skill, and the single-point-of-failure flag on billing has cleared.
In the Unified Product Graph, SkillTeam & OrganisationA skill or competency within a team is a leaf in the Operations & Quality region, skillteam_org domain. Two edges carry its meaning: a CertificationCustomer EducationA certification programView reference → proves competence through certificationCertificationvalidatesSkillcross-domain, and a certification_validates_skillTeamTeam & OrganisationA cross-functional teamView reference → records its capabilities through teamTeamskilled inSkillhierarchy. Connecting teams to skills, and skills to the certifications that evidence them, turns the skills matrix into a live query rather than a stale spreadsheet: you can ask which skills a team lacks for the work it owns, which capabilities rest on a single person, and where a build-or-hire decision is overdue.team_skilled_in_skill
Type-specific fields on BaseNode
skill_categorystringCategory of the skill (e.g. "technical", "leadership", "design")
proficiency_levelsstring[]Description of proficiency levels for this skill
domainstringProblem domain the skill applies to (e.g. "payments", "accessibility")
rarityobjectHow scarce this skill is in the labour market this team hires from
hours_to_proficiencynumberTypical hours of deliberate practice to reach working proficiency
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
2 edge types connected to this entity.
team_skilled_in_skillcertification_validates_skill