New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Kandev Escalation

by kdlbs in kdlbs/kandev

Escalate to a human when required information, access, credentials, or a product decision blocks completion and no reasonable default is available.

AGPL-3.0Auto-check passedProductivity & Automation

Install Kandev Escalation

skills CLI
$ npx skills add kdlbs/kandev --skill kandev-escalation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kdlbs/kandev kandev-escalation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kdlbs/kandev.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/backend/internal/office/configloader/skills/kandev-escalation .claude/skills/kandev-escalation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kandev-escalation
GitHub stars
909
Token cost
~825 tokens
SKILL.md length
371 words
Files
1
Skills in repo
45
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Escalate to a human when required information, access, credentials, or a product decision blocks completion and no reasonable default is available.

  • Works in 4 steps: Create the human task → Cross-reference from the blocked task → Set blocked status → …
  • Productivity & Automation work in your project
  • SKILL.md covers When to escalate, Escalation procedure, On human response and Rules
  • Calls jq

What it does

Kandev Escalation is an agent skill from kdlbs/kandev. Escalate to a human when required information, access, credentials, or a product decision blocks completion and no reasonable default is available.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation. The repository describes itself as: AI Kanban & Development Environment. Orchestrate multiple agents, review changes, open PRs. Multi-provider, self-hostable, no telemetry. The licence is AGPL-3.0.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “/kandev-escalation”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Create the human task
  2. Cross-reference from the blocked task
  3. Set blocked status
  4. Exit

What it can do on your machine

Read from SKILL.md and the folder at commit bd63da3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kandev Escalation loads about 825 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 371 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~825

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kdlbs/kandev at commit bd63da3, republished under its AGPL-3.0 licence (© kdlbs). 371 words, ~825 tokens.

Download SKILL.mdSave it as .claude/skills/kandev-escalation/SKILL.md (or your agent's skills folder).
name
kandev-escalation
description
Escalate to a human when required information, access, credentials, or a product decision blocks completion and no reasonable default is available.
kandev.system
true
kandev.version
0.42.0
kandev.default_for_roles
worker, specialist, assistant, reviewer

Escalating to a Human

Use this pattern when you cannot proceed without human input: a design decision, missing credentials, ambiguous requirements, or access you do not have.

When to escalate

Escalate when ALL of the following are true:

  1. You cannot make the decision yourself based on available context.
  2. The decision is required to complete your task.
  3. You have already checked comments and memory for prior guidance.

Do NOT escalate for routine technical choices you can make independently.

Escalation procedure

Step 1: Create the human task

Create a new task with a clear question as the title. Leave it unassigned (or assign to $KANDEV_HUMAN_USER_ID if that variable is set in your environment).

bash
HUMAN_TASK=$(
  $KANDEV_CLI kandev task create \
    --title "Decision needed: <your specific question here>" \
    --description "Context: <1-2 sentences of background>

Question: <the specific decision the human needs to make>

Options considered:
- Option A: <brief description>
- Option B: <brief description>

Blocked task: $KANDEV_TASK_ID" \
    2>/dev/null
)
HUMAN_TASK_ID=$(echo "$HUMAN_TASK" | jq -r '.task_id')
Step 2: Cross-reference from the blocked task
bash
$KANDEV_CLI kandev tasks message --id "$KANDEV_TASK_ID" \
  --prompt "Escalated to human task $HUMAN_TASK_ID. Waiting for decision on: <question>"

The Office CLI does not currently expose a secure operation for adding a blocker relationship. The human task description links back to the blocked task, and the comment above links the blocked task to the human task. Do not comment on the new human task: a run may only message tasks granted by its signed runtime scope. These references do not create a task dependency.

Step 3: Set blocked status
bash
$KANDEV_CLI kandev task update --status blocked
Step 4: Exit

Your session ends. Because this flow does not create a blocker relationship, the task_blockers_resolved wake reason will NOT occur for this manual cross-reference flow. The human or coordinator must post the decision on the blocked task or update it through the normal task workflow.

Show full SKILL.md (133 more words)Show less

On human response

Resume from the normal task comment or task update event. Parse $KANDEV_WAKE_PAYLOAD_JSON first; if it is absent, read the JSON file at $KANDEV_WAKE_PAYLOAD_PATH. Confirm the decision is present on the blocked task, move it back to the appropriate active status, and continue the work.

Rules

  • Keep the question in the title specific and actionable. "Decision needed: use PostgreSQL or SQLite for the cache layer?" is good. "I need help" is not.
  • Include enough context in the description that the human can decide without reading your full task history.
  • One escalation per decision. Do not create multiple human tasks for the same question.
  • If you need to escalate multiple independent decisions at once, create one human task per decision.
  • If you can make a reasonable default choice, prefer that over escalating.

© kdlbs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in apps/backend/internal/office/configloader/skills/kandev-escalation of kdlbs/kandev.

Open the folder on GitHubat commit bd63da3

Compare with similar skills

Kandev Escalation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kandev Escalation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kandev Escalation this skillkdlbs/kandev909—~825Automated safety check: PassAGPL-3.0
Agent Browserquran/quran.com-frontend-next1.9k40 repos~3.3kAutomated safety check: PassNone
Perform Tasktelegramdesktop/tdesktop33k2 repos~3kAutomated safety check: PassGPL-3.0
Dependency Watchtelegramdesktop/tdesktop33k—~2.2kAutomated safety check: PassGPL-3.0
Brave Searchbadlogic/pi-skills2.6k5 repos~592Automated safety check: PassMIT
Garden Inboxpaperclipai/paperclip99k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 40 repos~3.3k tokens
    Productivity & AutomationAuto-check passed

  • Perform Task

    telegramdesktop/tdesktop

    Resolve, start or resume, implement, review, test, and publish exactly one existing ai-tdesktop task by short slug or full dated id, including rare blocked retries and split-required results.

    33k GitHub starsUsed in 2 repos~3k tokens
    Productivity & AutomationAuto-check passed

  • Dependency Watch

    telegramdesktop/tdesktop

    Audit Telegram Desktop dependencies on freshly fetched origin/dev for releases and security fixes, including upstream lag and backport candidates in patched forks.

    33k GitHub stars~2.2k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Brave Search

    badlogic/pi-skills

    Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

    2.6k GitHub starsUsed in 5 repos~592 tokens
    Productivity & AutomationAuto-check passed

  • Garden Inbox

    paperclipai/paperclip

    Scan a Paperclip user's Mine inbox, classify reversible archive candidates, request checkbox confirmation, and archive only accepted selections.

    99k GitHub stars~1.1k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Continue

    telegramdesktop/tdesktop

    Continue autonomous Telegram Desktop development from the shared ai-tdesktop repository.

    33k GitHub starsUsed in 2 repos~9.4k tokens
    Productivity & AutomationAuto-check passed

More from kdlbs/kandev

All 45 skills in this repo

  • PR Walkthrough

    kdlbs/kandev

    Generate a single-file HTML walkthrough that explains a PR's purpose, user impact, interface changes, compatibility risks, and implementation.

    909 GitHub stars~6.3k tokensUpdated today
    Auto-check passed

  • Debug

    kdlbs/kandev

    Diagnose Kandev bugs, running-instance issues, UI/browser failures, and runtime behavior.

    909 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Harness Improvement

    kdlbs/kandev

    Improve Kandev's AI harness from session learnings or explicit requests.

    909 GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Diagram Design

    kdlbs/kandev

    Create branded architecture, IT current-state, flowchart, sequence, state machine, ER/data model, timeline, swimlane, quadrant, radar/spider, polar chart (polar/radial lollipop), loop/flywheel…

    909 GitHub starsUsed in 1 repo~8k tokens
    Auto-check passed

  • TDD

    kdlbs/kandev

    Implement changes using Test-Driven Development (Red-Green-Refactor).

    909 GitHub stars~4.2k tokensUpdated today
    Auto-check passed

  • Verify

    kdlbs/kandev

    Run a broad local verification audit only when the user explicitly requests it or PR/CI remediation requires it.

    909 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Categories

Questions about Kandev Escalation

What does Kandev Escalation do?

Escalate to a human when required information, access, credentials, or a product decision blocks completion and no reasonable default is available. Kandev Escalation is an agent skill from kdlbs/kandev. Escalate to a human when required information, access, credentials, or a product decision blocks completion and no reasonable default is available.

When should I use Kandev Escalation?

Kandev Escalation fits situations like: productivity & Automation work in your project.

How do I install Kandev Escalation in Claude Code?

Run `npx skills add kdlbs/kandev --skill kandev-escalation -a claude-code`. Or copy the skill folder (apps/backend/internal/office/configloader/skills/kandev-escalation in kdlbs/kandev) into .claude/skills/kandev-escalation in your project. Claude Code loads it when a task matches its description.

How do I install Kandev Escalation in Codex?

Run `npx skills add kdlbs/kandev --skill kandev-escalation -a codex`. Or copy the skill folder (apps/backend/internal/office/configloader/skills/kandev-escalation in kdlbs/kandev) into .agents/skills/kandev-escalation in your project. Codex loads it when a task matches its description.

Can I use Kandev Escalation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kdlbs/kandev --skill kandev-escalation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kandev-escalation, .gemini/skills/kandev-escalation, .github/skills/kandev-escalation and .opencode/skills/kandev-escalation in your project.

What does Kandev Escalation need to run?

Going by SKILL.md and its folder, Kandev Escalation needs the command-line tools its instructions call (jq).

Does Kandev Escalation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kandev Escalation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kandev Escalation use?

Kandev Escalation is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kandev Escalation use?

About 825 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kandev Escalation?

Skills that share tags, products or a category with Kandev Escalation: Agent Browser (quran/quran.com-frontend-next, 1.9k stars), Perform Task (telegramdesktop/tdesktop, 33k stars), Dependency Watch (telegramdesktop/tdesktop, 33k stars) and Brave Search (badlogic/pi-skills, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kandev Escalation?

kdlbs (a GitHub organization) maintains it in kdlbs/kandev, which has 909 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 9, 2026.

Source: kdlbs/kandev on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.