Onboarding Skill
Define the default Custom Agent Skill that helps coding agents onboard to projects in your organization.
The Onboarding Skill lets organization admins define the default Custom Agent Skill that coding agents receive when they install skills from Confident AI.
Use it to standardize how product teams onboard with tools like Claude Code, Codex, Cursor, Windsurf, and other agents that support the Agent Skills standard. The skill can include repository conventions, setup commands, test and eval workflows, tracing expectations, and team-specific instructions.

Configure the onboarding skill
To configure the organization onboarding skill:
- Navigate to Organization Settings → Onboarding Skill
- Review the Install skills repo command
- Enter a Description that summarizes how the skill should guide coding agents
- Add the full markdown content in Skill Body
- Click Save
The Description becomes the skill frontmatter description in SKILL.md. The Skill Body becomes the markdown body that coding agents read and follow.
Install the skill
The Onboarding Skill page shows the install command for your organization's skills repository:
npx skills add "https://apikey:PROJECT_API_KEY@<host>/skills.git" --skill onboardingReplace PROJECT_API_KEY with the Project API Key for the project the product team is working in.
The --skill onboarding flag is required so the Skills CLI installs the onboarding skill from the repository.
What to include
Good onboarding skills give coding agents enough context to make useful changes without asking every team the same setup questions. Include instructions such as:
- required setup and dependency installation commands
- how to run tests, evals, linters, and type checks
- repository conventions and code ownership expectations
- how to instrument traces and send results to Confident AI
- which files or workflows require extra care
- examples of prompts product teams should use with their coding agent
Keep the organization-level onboarding skill broad enough to apply across teams. Use project-specific onboarding skills only when a project has special commands, architecture, or release requirements.
Related guides
Custom Agent Skills Guide
Serve project-specific onboarding and governance instructions from Confident AI.
Organization Projects
Manage the projects that use Project API Keys to resolve their skills.
Last updated on