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.