Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Eight composable skills. All are user-invocable, so you can ask for any of them
<tr><td><code>getting-started</code></td><td>You're new and don't know where to begin</td></tr>
<tr><td><code>status</code></td><td>You're coming back and want to see what's running</td></tr>
<tr><td><code>create-cluster</code></td><td>You need a cluster</td></tr>
<tr><td><code>login</code></td><td>You need to (re)connect to a cluster</td></tr>
<tr><td><code>cluster-login</code></td><td>You need to (re)connect to a cluster</td></tr>
<tr><td><code>prepare-app</code></td><td>You want to check your app is ready to deploy</td></tr>
<tr><td><code>deploy-app</code></td><td>You're ready to put your app on the cluster</td></tr>
<tr><td><code>expose-app</code></td><td>You want a URL that points to your app</td></tr>
Expand Down
4 changes: 2 additions & 2 deletions skills/login/SKILL.md → skills/cluster-login/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
name: login
name: cluster-login
description: Logs the user into their Intility Developer Platform cluster so they can run kubectl/oc commands against it. Use when the user asks to "log in", "log into the cluster", "connect to my cluster", "oc login", or when another skill needs cluster access and the user is not authenticated.
allowed-tools:
- AskUserQuestion
Expand All @@ -9,7 +9,7 @@ allowed-tools:
- Bash(oc get nodes*)
---

# Login
# Cluster login

## Goal

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Claude: [oc whoami → ok]

---

## Common phrasings that trigger login
## Common phrasings that trigger cluster-login

- "log me in"
- "log into my cluster"
Expand Down
4 changes: 2 additions & 2 deletions skills/create-cluster/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ If there is already at least one cluster, **do not create another**. Show what's
```
Q: "You already have a cluster (<name>). Use that one?"
Options:
- "Yes, use it" → hand off to the login skill
- "Yes, use it" → hand off to the cluster-login skill
- "No, I really need another" → continue
```

Expand Down Expand Up @@ -105,7 +105,7 @@ If it's been more than 15 minutes and still `In Deployment`, stop polling and as

## Step 6 — Hand off

Once `Ready`, tell the user briefly and invoke the **login** skill next:
Once `Ready`, tell the user briefly and invoke the **cluster-login** skill next:

```
Cluster '<full-cluster-name>' is ready. Logging you in now.
Expand Down
4 changes: 2 additions & 2 deletions skills/create-cluster/references/usage-examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Claude: [indev cluster create --name shop --preset minimal --nodes 2]
… 6 minutes later …

Cluster 'shop-a3k9x2' is ready. Logging you in now.
→ invoking login
→ invoking cluster-login
```

---
Expand All @@ -37,7 +37,7 @@ Claude: [indev cluster list → shop-a3k9x2]
[ ] No, I really need another

You: Yes
Claude: → invoking login
Claude: → invoking cluster-login
```

---
Expand Down
4 changes: 2 additions & 2 deletions skills/deploy-app/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,11 @@ Generate three manifest files (`namespace.yaml`, `deployment.yaml`, `service.yam
oc whoami
```

If it errors, run the `login` skill first. Don't proceed without auth.
If it errors, run the `cluster-login` skill first. Don't proceed without auth.

## If `oc` returns "Unauthorized" mid-flow

The `oc` token has expired. Don't retry the failing command. Stop where you are, route to the `login` skill, then resume from the failed step.
The `oc` token has expired. Don't retry the failing command. Stop where you are, route to the `cluster-login` skill, then resume from the failed step.

If an `indev` command says "Unauthorized" instead, run `indev login` and resume.

Expand Down
4 changes: 2 additions & 2 deletions skills/expose-app/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,11 @@ The domain each gateway uses is the organization's own — not hardcoded in this
oc whoami
```

If it errors, route to `login` first.
If it errors, route to `cluster-login` first.

## If `oc` returns "Unauthorized" mid-flow

The `oc` token has expired. Don't retry the failing command. Stop where you are, route to the `login` skill, then resume from the failed step.
The `oc` token has expired. Don't retry the failing command. Stop where you are, route to the `cluster-login` skill, then resume from the failed step.

## Step 1 — Find the gateways

Expand Down
4 changes: 2 additions & 2 deletions skills/getting-started/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,8 +83,8 @@ Based on the destination, invoke the right skill in this order. Do not do these

| Goal | Skill order |
|---|---|
| First time, full journey | `create-cluster` → `login` → `prepare-app` → `deploy-app` → `expose-app` |
| Has cluster, new app | `login` (if needed) → `prepare-app` → `deploy-app` → `expose-app` |
| First time, full journey | `create-cluster` → `cluster-login` → `prepare-app` → `deploy-app` → `expose-app` |
| Has cluster, new app | `cluster-login` (if needed) → `prepare-app` → `deploy-app` → `expose-app` |
| Just need a URL | `expose-app` |
| Just bumping a version | `update-image` |
| Coming back after a break — what's running? | `status` |
Expand Down
2 changes: 1 addition & 1 deletion skills/getting-started/references/usage-examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Claude: [indev cluster create --name shop --preset minimal --nodes 2]
Creating your cluster (shop-a3k9x2) — this takes 5–10 minutes.
… 7 minutes later …
Ready. Logging you in now.
→ invoking login
→ invoking cluster-login

Claude: A browser will open. Sign in with your Intility account, then come back here.
You: [signs in]
Expand Down
4 changes: 2 additions & 2 deletions skills/status/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ This skill is **read-only**. It changes nothing. It also persists nothing — it

## If `oc` returns "Unauthorized" mid-flow

The `oc` token has expired. Don't retry the failing command. Route the user to the `login` skill, then resume.
The `oc` token has expired. Don't retry the failing command. Route the user to the `cluster-login` skill, then resume.

## Step 1 — Cluster

Expand All @@ -38,7 +38,7 @@ Otherwise, capture the full cluster name (including suffix).
oc whoami
```

If it errors, tell the user and suggest the `login` skill. Show the cluster name and basic info from `indev cluster list` first so they at least see what they have, then stop.
If it errors, tell the user and suggest the `cluster-login` skill. Show the cluster name and basic info from `indev cluster list` first so they at least see what they have, then stop.

If it works, also grab the cluster name from the API URL — useful for showing hostnames:

Expand Down
4 changes: 2 additions & 2 deletions skills/update-image/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@ Roll a deployed app to a new image tag. Then update the local manifest so the fi
oc whoami
```

If it errors, route to `login` first.
If it errors, route to `cluster-login` first.

## If `oc` returns "Unauthorized" mid-flow

The `oc` token has expired. Don't retry the failing command. Stop where you are, route to the `login` skill, then resume from the failed step.
The `oc` token has expired. Don't retry the failing command. Stop where you are, route to the `cluster-login` skill, then resume from the failed step.

## Step 1 — Figure out which app

Expand Down