Skip to content

This is a community translation of the original Chinese text. The translation may contain inaccuracies. When in doubt, please refer to the original Chinese version.

Role-Specific Skills Are Onboarding Training

The first face of a skill points inward: onboarding training.

Every new hire spends their first stretch learning things specific to this one company: how to log into the internal systems, how expense reports work, what the codebase conventions are, what the local jargon means. All of it becomes worthless at the next company — but it's what turns someone from "has general skills" into "can do the work here."

Turn Role Knowledge into Skills

Onboarding an agent means packaging the role's specific procedures, domain knowledge, and internal tool usage into skills.

The alternative is to dump all role knowledge into the system prompt. It works at first. Then the prompt keeps growing, until half the JD is job responsibilities and the other half is "clause seventeen of our reconciliation rules." Job description and operations manual blur into one mass. Changing anything means hunting through a wall of text, and reuse is out of the question.

Package it as skills and things get clean. Job competence stops being a slab of text hardcoded into a prompt and becomes a maintainable, versionable, reusable module. When the reconciliation rules change, you change that skill — the JD stays untouched. When a new agent joins in the same role, you hand it the same onboarding package and it's ready to work.

Onboarding Training Is Role-Specific

Onboarding training has a boundary: it is role-specific and does not naturally transfer.

Internal procedures and the workings of private systems mean nothing outside this company, and you shouldn't expect them to work anywhere else. That's not a defect; it's division of labor — onboarding training exists precisely to serve one specific role. It belongs to a different category than certification, with different design standards. Confuse the two and you either force role-specific material to be generic (wasted effort) or lock a genuinely transferable capability inside a single role (a wasted asset).

First identify which of your skills are onboarding training — valid only in this role, at this company. What remains, the skills that travel wherever the agent goes, are the certifications.