How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

check-commands - Prompt - OpenSmartRoute

Name: check-commands
Author: talent-factory

Prompt file imported from talent-factory/ai-project-example (.windsurf/workflows/develop/check-commands.md). Copyright stays with the author.

Command Validation Tool

Dieser Command validiert Claude Code Commands auf:

YAML-Frontmatter Struktur
Markdown-Syntax
Dokumentation
Best Practices (Progressive Disclosure, Naming Conventions)

Usage

# Spezifischen Command prüfen
/develop:check-commands .claude/commands/develop/commit.md

# Oder ohne Pfad für interaktive Auswahl
/develop:check-commands

Validierungs-Checks

1. YAML-Frontmatter

Required:

description (String, 1-100 Zeichen)
category (String, muss existierendem Ordner entsprechen)

Optional:

allowed-tools (Array von Tool-Namen)

Format:

---
description: Kurze Beschreibung des Commands
category: develop
allowed-tools:
  - Read
  - Write
---

2. Markdown-Struktur

Muss mit Frontmatter beginnen
Mindestens eine H1-Überschrift (# Titel)
Valides CommonMark-Format
Keine kaputten Links zu Detail-Dateien

3. Dokumentation

Für umfangreiche Commands (Progressive Disclosure):

Command-Unterordner mit gleichem Namen
Detail-Dateien im Unterordner
Referenzen im Haupt-Command auf Detail-Dateien

Beispiel-Struktur:

develop/
├── commit.md                    # Haupt-Command
└── commit/                      # Detail-Ordner
    ├── pre-commit-checks.md
    ├── commit-types.md
    ├── best-practices.md
    └── troubleshooting.md

4. Best Practices

Naming Conventions:

✅ Lowercase mit Bindestrichen: check-commands.md
❌ CamelCase oder Unterstriche: checkCommands.md, check_commands.md

Progressive Disclosure:

Haupt-Command: 50-250 Zeilen (Übersicht + Workflow)
Details: In separaten Dateien ausgelagert
Referenzen: Links zu Detail-Dateien am Ende

Description:

Kurz und prägnant (1-100 Zeichen)
Beschreibt WAS der Command tut
Imperativ-Form: "Erstellt..." nicht "Erstelle..."
Sprache: Deutsch (technische Begriffe auf Englisch erlaubt)

Dokumentation (Markdown-Body):

Primär auf Deutsch verfasst
Technische Begriffe können auf Englisch bleiben
Fachbegriffe auf Englisch erlaubt
Konsistente Sprache innerhalb eines Commands

Validierungs-Workflow

Wenn du diesen Command ausführst, solltest du:

Command-Pfad ermitteln:
- Falls kein Pfad angegeben: Alle .md-Dateien in .claude/commands/ listen
- User wählt Command aus
Datei einlesen:
- Read-Tool verwenden
- Prüfen ob Datei existiert
YAML-Frontmatter parsen:
- Ersten Block zwischen --- extrahieren
- Required-Felder prüfen: description, category
- Optional-Felder validieren: allowed-tools
- Format-Validierung (keine Syntax-Fehler)
Markdown validieren:
- Mindestens eine H1-Überschrift vorhanden
- Keine kaputten internen Links
- Grundlegende CommonMark-Struktur
Dokumentations-Check:
- Falls Command > 250 Zeilen: Warnung für Progressive Disclosure
- Falls Unterordner existiert: Detail-Dateien prüfen
- Falls Referenzen vorhanden: Existenz der Dateien prüfen
Best Practices Check:
- Dateiname: Lowercase mit Bindestrichen
- Category: Muss existierendem Ordner entsprechen
- Description: 1-100 Zeichen

Report ausgeben:

## Validation Report: /develop:commit

✅ YAML-Frontmatter: Valid
✅ Markdown-Struktur: Valid
✅ Dokumentation: Complete
✅ Best Practices: Compliant
✅ Progressive Disclosure: Implemented (85 lines main, 1246 lines details)

### Details:
- Category: develop (exists ✓)
- Description: "Erstellt professionelle Git-Commits..." (Valid length)
- Detail files: 4 found (all referenced ✓)
- Naming: check-commands.md (compliant ✓)

✨ Command is fully compliant!

Bei Problemen:

## Validation Report: /develop:example

❌ YAML-Frontmatter: Missing 'description' field
⚠️  Markdown-Struktur: No H1 heading found
✅ Best Practices: Compliant
⚠️  File size: 312 lines - consider Progressive Disclosure

### Issues to fix:
1. Add 'description' field to YAML frontmatter
2. Add H1 heading (# Title) at the beginning
3. Consider splitting into main + detail files (>250 lines)

### Recommended actions:
- Add description: "Brief command description"
- Add # heading after frontmatter
- Create detail folder: .claude/commands/develop/example/

Error Handling

Datei nicht gefunden: Klare Fehlermeldung mit Pfad
YAML-Parse-Fehler: Zeige Zeile und Fehler
Fehlende Required-Felder: Liste alle fehlenden Felder
Kategorie existiert nicht: Zeige verfügbare Kategorien

Integration mit anderen Commands

Dieser Command ist nützlich:

Vor dem Commit: Commands validieren bevor sie commited werden
Nach Änderungen: Sicherstellen dass alles noch funktioniert
Neue Commands: Initiales Setup überprüfen

Beispiele

Erfolgreiche Validierung:

/develop:check-commands .claude/commands/develop/commit.md
→ ✅ Alle Checks bestanden

Fehlerhafte Validierung:

/develop:check-commands .claude/commands/develop/broken.md
→ ❌ 3 Issues gefunden (siehe Report)

Interaktive Auswahl:

/develop:check-commands
→ Zeigt Liste aller Commands
→ User wählt aus
→ Validierung läuft

Notes

Dieser Command sollte selbst Best Practices folgen ✨
Kann als Template für andere Validierungs-Commands dienen
Erweiterbar für zusätzliche Checks (z.B. Security, Performance)

Install check-commands and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Command Validation Tool Dieser Command validiert Claude Code Commands auf: - YAML-Frontmatter Struktur - Markdown-Syntax - Dokumentation - Best Practices (Progressive Disclosure, Naming Conventions) ## Usage ```bash # Spezifischen Command prüfen /develop:check-commands .claude/commands/develop/commit.md # Oder ohne Pfad für interaktive Auswahl /develop:check-commands ``` ## Validierungs-Checks ### 1. YAML-Frontmatter **Required**: - `description` (String, 1-100 Zeichen) - `category` (String, muss existierendem Ordner entsprechen) **Optional**: - `allowed-tools` (Array von Tool-Namen) **Format**: ```yaml --- description: Kurze Beschreibung des Commands category: develop allowed-tools: - Read - Write --- ``` ### 2. Markdown-Struktur - Muss mit Frontmatter beginnen - Mindestens eine H1-Überschrift (`# Titel`) - Valides CommonMark-Format - Keine kaputten Links zu Detail-Dateien ### 3. Dokumentation **Für umfangreiche Commands (Progressive Disclosure)**: - Command-Unterordner mit gleichem Namen - Detail-Dateien im Unterordner - Referenzen im Haupt-Command auf Detail-Dateien **Beispiel-Struktur**: ```text develop/ ├── commit.md # Haupt-Command └── commit/ # Detail-Ordner ├── pre-commit-checks.md ├── commit-types.md ├── best-practices.md └── troubleshooting.md ``` ### 4. Best Practices **Naming Conventions**: - ✅ Lowercase mit Bindestrichen: `check-commands.md` - ❌ CamelCase oder Unterstriche: `checkCommands.md`, `check_commands.md` **Progressive Disclosure**: - Haupt-Command: 50-250 Zeilen (Übersicht + Workflow) - Details: In separaten Dateien ausgelagert - Referenzen: Links zu Detail-Dateien am Ende **Description**: - Kurz und prägnant (1-100 Zeichen) - Beschreibt WAS der Command tut - Imperativ-Form: "Erstellt..." nicht "Erstelle..." - **Sprache: Deutsch** (technische Begriffe auf Englisch erlaubt) **Dokumentation (Markdown-Body)**: - **Primär auf Deutsch** verfasst - Technische Begriffe können auf Englisch bleiben - Fachbegriffe auf Englisch erlaubt - Konsistente Sprache innerhalb eines Commands ## Validierungs-Workflow Wenn du diesen Command ausführst, solltest du: 1. **Command-Pfad ermitteln**: - Falls kein Pfad angegeben: Alle `.md`-Dateien in `.claude/commands/` listen - User wählt Command aus 2. **Datei einlesen**: - Read-Tool verwenden - Prüfen ob Datei existiert 3. **YAML-Frontmatter parsen**: - Ersten Block zwischen `---` extrahieren - Required-Felder prüfen: `description`, `category` - Optional-Felder validieren: `allowed-tools` - Format-Validierung (keine Syntax-Fehler) 4. **Markdown validieren**: - Mindestens eine H1-Überschrift vorhanden - Keine kaputten internen Links - Grundlegende CommonMark-Struktur 5. **Dokumentations-Check**: - Falls Command > 250 Zeilen: Warnung für Progressive Disclosure - Falls Unterordner existiert: Detail-Dateien prüfen - Falls Referenzen vorhanden: Existenz der Dateien prüfen 6. **Best Practices Check**: - Dateiname: Lowercase mit Bindestrichen - Category: Muss existierendem Ordner entsprechen - Description: 1-100 Zeichen 7. **Report ausgeben**: ```markdown ## Validation Report: /develop:commit ✅ YAML-Frontmatter: Valid ✅ Markdown-Struktur: Valid ✅ Dokumentation: Complete ✅ Best Practices: Compliant ✅ Progressive Disclosure: Implemented (85 lines main, 1246 lines details) ### Details: - Category: develop (exists ✓) - Description: "Erstellt professionelle Git-Commits..." (Valid length) - Detail files: 4 found (all referenced ✓) - Naming: check-commands.md (compliant ✓) ✨ Command is fully compliant! ``` Bei Problemen: ```markdown ## Validation Report: /develop:example ❌ YAML-Frontmatter: Missing 'description' field ⚠️ Markdown-Struktur: No H1 heading found ✅ Best Practices: Compliant ⚠️ File size: 312 lines - consider Progressive Disclosure ### Issues to fix: 1. Add 'description' field to YAML frontmatter 2. Add H1 heading (# Title) at the beginning 3. Consider splitting into main + detail files (>250 lines) ### Recommended actions: - Add description: "Brief command description" - Add # heading after frontmatter - Create detail folder: .claude/commands/develop/example/ ``` ## Error Handling - **Datei nicht gefunden**: Klare Fehlermeldung mit Pfad - **YAML-Parse-Fehler**: Zeige Zeile und Fehler - **Fehlende Required-Felder**: Liste alle fehlenden Felder - **Kategorie existiert nicht**: Zeige verfügbare Kategorien ## Integration mit anderen Commands Dieser Command ist nützlich: - **Vor dem Commit**: Commands validieren bevor sie commited werden - **Nach Änderungen**: Sicherstellen dass alles noch funktioniert - **Neue Commands**: Initiales Setup überprüfen ## Beispiele **Erfolgreiche Validierung**: ```text /develop:check-commands .claude/commands/develop/commit.md → ✅ Alle Checks bestanden ``` **Fehlerhafte Validierung**: ```text /develop:check-commands .claude/commands/develop/broken.md → ❌ 3 Issues gefunden (siehe Report) ``` **Interaktive Auswahl**: ```text /develop:check-commands → Zeigt Liste aller Commands → User wählt aus → Validierung läuft ``` ## Notes - Dieser Command sollte selbst Best Practices folgen ✨ - Kann als Template für andere Validierungs-Commands dienen - Erweiterbar für zusätzliche Checks (z.B. Security, Performance)

{ "prompt": "# Command Validation Tool\n\nDieser Command validiert Claude Code Commands auf:\n\n- YAML-Frontmatter Struktur\n- Markdown-Syntax\n- Dokumentation\n- Best Practices (Progressive Disclosure, Naming Conventions)\n\n## Usage\n\n```bash\n# Spezifischen Command prüfen\n/develop:check-commands .claude/commands/develop/commit.md\n\n# Oder ohne Pfad für interaktive Auswahl\n/develop:check-commands\n```\n\n## Validierungs-Checks\n\n### 1. YAML-Frontmatter\n\n**Required**:\n\n- `description` (String, 1-100 Zeichen)\n- `category` (String, muss existierendem Ordner entsprechen)\n\n**Optional**:\n\n- `allowed-tools` (Array von Tool-Namen)\n\n**Format**:\n\n```yaml\n---\ndescription: Kurze Beschreibung des Commands\ncategory: develop\nallowed-tools:\n - Read\n - Write\n---\n```\n\n### 2. Markdown-Struktur\n\n- Muss mit Frontmatter beginnen\n- Mindestens eine H1-Überschrift (`# Titel`)\n- Valides CommonMark-Format\n- Keine kaputten Links zu Detail-Dateien\n\n### 3. Dokumentation\n\n**Für umfangreiche Commands (Progressive Disclosure)**:\n\n- Command-Unterordner mit gleichem Namen\n- Detail-Dateien im Unterordner\n- Referenzen im Haupt-Command auf Detail-Dateien\n\n**Beispiel-Struktur**:\n\n```text\ndevelop/\n├── commit.md # Haupt-Command\n└── commit/ # Detail-Ordner\n ├── pre-commit-checks.md\n ├── commit-types.md\n ├── best-practices.md\n └── troubleshooting.md\n```\n\n### 4. Best Practices\n\n**Naming Conventions**:\n\n- ✅ Lowercase mit Bindestrichen: `check-commands.md`\n- ❌ CamelCase oder Unterstriche: `checkCommands.md`, `check_commands.md`\n\n**Progressive Disclosure**:\n\n- Haupt-Command: 50-250 Zeilen (Übersicht + Workflow)\n- Details: In separaten Dateien ausgelagert\n- Referenzen: Links zu Detail-Dateien am Ende\n\n**Description**:\n\n- Kurz und prägnant (1-100 Zeichen)\n- Beschreibt WAS der Command tut\n- Imperativ-Form: \"Erstellt...\" nicht \"Erstelle...\"\n- **Sprache: Deutsch** (technische Begriffe auf Englisch erlaubt)\n\n**Dokumentation (Markdown-Body)**:\n\n- **Primär auf Deutsch** verfasst\n- Technische Begriffe können auf Englisch bleiben\n- Fachbegriffe auf Englisch erlaubt\n- Konsistente Sprache innerhalb eines Commands\n\n## Validierungs-Workflow\n\nWenn du diesen Command ausführst, solltest du:\n\n1. **Command-Pfad ermitteln**:\n - Falls kein Pfad angegeben: Alle `.md`-Dateien in `.claude/commands/` listen\n - User wählt Command aus\n\n2. **Datei einlesen**:\n - Read-Tool verwenden\n - Prüfen ob Datei existiert\n\n3. **YAML-Frontmatter parsen**:\n - Ersten Block zwischen `---` extrahieren\n - Required-Felder prüfen: `description`, `category`\n - Optional-Felder validieren: `allowed-tools`\n - Format-Validierung (keine Syntax-Fehler)\n\n4. **Markdown validieren**:\n - Mindestens eine H1-Überschrift vorhanden\n - Keine kaputten internen Links\n - Grundlegende CommonMark-Struktur\n\n5. **Dokumentations-Check**:\n - Falls Command > 250 Zeilen: Warnung für Progressive Disclosure\n - Falls Unterordner existiert: Detail-Dateien prüfen\n - Falls Referenzen vorhanden: Existenz der Dateien prüfen\n\n6. **Best Practices Check**:\n - Dateiname: Lowercase mit Bindestrichen\n - Category: Muss existierendem Ordner entsprechen\n - Description: 1-100 Zeichen\n\n7. **Report ausgeben**:\n\n ```markdown\n ## Validation Report: /develop:commit\n\n ✅ YAML-Frontmatter: Valid\n ✅ Markdown-Struktur: Valid\n ✅ Dokumentation: Complete\n ✅ Best Practices: Compliant\n ✅ Progressive Disclosure: Implemented (85 lines main, 1246 lines details)\n\n ### Details:\n - Category: develop (exists ✓)\n - Description: \"Erstellt professionelle Git-Commits...\" (Valid length)\n - Detail files: 4 found (all referenced ✓)\n - Naming: check-commands.md (compliant ✓)\n\n ✨ Command is fully compliant!\n ```\n\n Bei Problemen:\n\n ```markdown\n ## Validation Report: /develop:example\n\n ❌ YAML-Frontmatter: Missing 'description' field\n ⚠️ Markdown-Struktur: No H1 heading found\n ✅ Best Practices: Compliant\n ⚠️ File size: 312 lines - consider Progressive Disclosure\n\n ### Issues to fix:\n 1. Add 'description' field to YAML frontmatter\n 2. Add H1 heading (# Title) at the beginning\n 3. Consider splitting into main + detail files (>250 lines)\n\n ### Recommended actions:\n - Add description: \"Brief command description\"\n - Add # heading after frontmatter\n - Create detail folder: .claude/commands/develop/example/\n ```\n\n## Error Handling\n\n- **Datei nicht gefunden**: Klare Fehlermeldung mit Pfad\n- **YAML-Parse-Fehler**: Zeige Zeile und Fehler\n- **Fehlende Required-Felder**: Liste alle fehlenden Felder\n- **Kategorie existiert nicht**: Zeige verfügbare Kategorien\n\n## Integration mit anderen Commands\n\nDieser Command ist nützlich:\n\n- **Vor dem Commit**: Commands validieren bevor sie commited werden\n- **Nach Änderungen**: Sicherstellen dass alles noch funktioniert\n- **Neue Commands**: Initiales Setup überprüfen\n\n## Beispiele\n\n**Erfolgreiche Validierung**:\n\n```text\n/develop:check-commands .claude/commands/develop/commit.md\n→ ✅ Alle Checks bestanden\n```\n\n**Fehlerhafte Validierung**:\n\n```text\n/develop:check-commands .claude/commands/develop/broken.md\n→ ❌ 3 Issues gefunden (siehe Report)\n```\n\n**Interaktive Auswahl**:\n\n```text\n/develop:check-commands\n→ Zeigt Liste aller Commands\n→ User wählt aus\n→ Validierung läuft\n```\n\n## Notes\n\n- Dieser Command sollte selbst Best Practices folgen ✨\n- Kann als Template für andere Validierungs-Commands dienen\n- Erweiterbar für zusätzliche Checks (z.B. Security, Performance)", "variables": [], "notes": "Validiert Command-Dateien, Dokumentation und Best Practices Tools: Read, Glob, Grep, Bash.", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/talent-factory/ai-project-example", "path": ".windsurf/workflows/develop/check-commands.md", "ref": "0a3756e292fc9b2f2cc1c875a5001a0c28ad65f3", "url": "https://github.com/talent-factory/ai-project-example/blob/0a3756e292fc9b2f2cc1c875a5001a0c28ad65f3/.windsurf/workflows/develop/check-commands.md", "key": "talent-factory/ai-project-example/.windsurf/workflows/develop/check-commands.md" } } }

check-commands

About

Command Validation Tool

Usage

Validierungs-Checks

1. YAML-Frontmatter

2. Markdown-Struktur

3. Dokumentation

4. Best Practices

Validierungs-Workflow

Error Handling

Integration mit anderen Commands

Beispiele

Notes

Install check-commands and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews