okteto-onboarding

Discover services and draft an Okteto manifest for repos without one.

5|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/okteto/okteto-claude-plugins --skill okteto-onboarding
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: okteto-onboarding
Source: https://github.com/okteto/okteto-claude-plugins/tree/main/plugins/okteto/skills/onboarding
Command: npx skills add https://github.com/okteto/okteto-claude-plugins --skill okteto-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboards a new repository onto Okteto when no okteto.yaml/okteto.yml exists, by automatically discovering services (docker-compose, Helm charts, k8s manifests, or Dockerfiles), drafting an Okteto manifest, and validating it through a guided ladder until handoff to the okteto skill.

Core Features & Use Cases

  • Discovers services from docker-compose, Helm charts, k8s manifests, or Dockerfiles to draft an Okteto manifest.
  • Validates the manifest via a tiered ladder (validate → build → deploy) and hands off to the existing okteto skill.
  • Proactively prevents activation if a manifest already exists, ensuring it does not override existing setups.

Quick Start

Draft an Okteto manifest for my repository and begin onboarding.

Frequently Asked Questions about okteto-onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an Okteto manifest for a repository with docker-compose or Helm charts?▼

To generate an Okteto manifest, the skill discovers services from docker-compose, Helm charts, Kubernetes manifests, or Dockerfiles and drafts a valid okteto.yaml file for onboarding.

Can I automatically create an okteto.yaml if one already exists in my repository?▼

No, if an okteto.yaml or okteto.yml already exists, the skill proactively prevents activation to ensure it does not override your existing Okteto manifest setup.

What is the best way to onboard a Kubernetes repository to Okteto without a manifest?▼

The best way to onboard is by discovering your existing Kubernetes manifests or Helm charts and drafting a new Okteto manifest validated through a tiered build and deploy ladder.

Does the Okteto onboarding process work with Dockerfiles directly?▼

Yes, the onboarding process works with Dockerfiles directly, targeting them alongside docker-compose and Helm charts to produce a valid Okteto manifest for your repository.

How do I validate a drafted Okteto manifest before deploying?▼

You validate a drafted Okteto manifest using a guided tiered ladder that sequentially checks the manifest through validate, build, and deploy stages before final handoff.

What happens after the Okteto manifest is drafted and validated?▼

After the Okteto manifest is drafted and validated through the tiered ladder, the workflow completes by prompting for validation and handing off control to the okteto skill.