# Plano Config Fundamentals

> Validate and fix Plano config fundamentals. Use for config versioning, listener types, provider registration, secrets handling, and startup validation failures.

- Skill: `katanemo/plano-config-fundamentals` (Agent Skill)
- Install (CLI): `npx skillmds@latest add katanemo/plano-config-fundamentals`
- Raw SKILL.md: https://api.skillmd.com/api/skills/katanemo/plano-config-fundamentals/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: katanemo (https://skillmd.com/u/katanemo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/katanemo/plano-config-fundamentals

---


# Plano Configuration Fundamentals

Use this skill for foundational `config.yaml` correctness.

## When To Use

- "Validate this Plano config"
- "Fix startup config errors"
- "Check listeners/providers/secrets"
- "Why does `planoai up` fail schema validation?"

## Apply These Rules

- `config-version`
- `config-listeners`
- `config-providers`
- `config-secrets`

## Execution Checklist

1. Ensure `version: v0.3.0` is present.
2. Confirm listener type matches intended architecture.
3. Verify provider names/interfaces and exactly one default provider.
4. Replace hardcoded secrets with `$ENV_VAR` substitution.
5. Return minimal patch and a `planoai up` verification plan.