Skip to content

feat(keboola-cli): add job-error-triage skill - #87

Draft
claude[bot] wants to merge 4 commits into
mainfrom
add-job-error-triage-skill
Draft

feat(keboola-cli): add job-error-triage skill#87
claude[bot] wants to merge 4 commits into
mainfrom
add-job-error-triage-skill

Conversation

@claude

@claude claude Bot commented Jul 15, 2026

Copy link
Copy Markdown

Requested via Slack thread

Before / After

Before: When a Keboola job, deploy, or config write fails, it's easy to fire several speculative config writes in a row — retrying different writes hoping one sticks — and to report success on a change that never actually applied (for example, a write whose approval timed out so nothing was written, or a modify_flow write that failed silently).

After: A disciplined triage loop that replaces speculative multi-write attempts — read the actual error → diagnose one root cause → propose one config diff → make one gated write (show the diff and confirm first) → verify the change applied before reporting success. The skill spells out stop conditions for rejected, timed-out, and silent writes, forbids claiming "Done" on an unconfirmed write, and adds a halt-on-repeated-failure rule for bulk edits.

How

  • New skill: plugins/keboola-cli/skills/job-error-triage/SKILL.md (prose-only, no scripts), frontmatter name: job-error-triage, version: 1.2.0 — consistent with the sibling keboola-cli skills.
  • Documented the skill in plugins/keboola-cli/README.md.
  • Bumped keboola-cli to 1.2.0 in both plugins/keboola-cli/.claude-plugin/plugin.json and the root .claude-plugin/marketplace.json.
  • Added the skill to the keboola-cli feature list in the root README.md.
  • claude plugin validate . passes.

Requested by Jordan Burger.

Note

This skill is distinct from the existing component-developer:debug-component skill: debug-component debugs component source code, while job-error-triage is about config/job write discipline (one gated write, verify it applied). The two are cross-linked in the skill text. Reviewers may want to confirm keboola-cli is the right home for this skill.

claude added 4 commits July 15, 2026 16:46
Add a disciplined triage loop for a single job/deploy/config-write
failure that replaces firing multiple speculative config writes.

The skill enforces: read the actual error log first, one root-cause
diagnosis, one proposed config diff, one gated write, then verify the
change actually applied before reporting success. Covers stop
conditions for rejected/timed-out/silent writes and the
halt-on-repeated-failure rule for bulk edits.

- New skill: plugins/keboola-cli/skills/job-error-triage/SKILL.md
- Document skill in plugins/keboola-cli/README.md
- Bump keboola-cli to 1.2.0 in plugin.json and marketplace.json
- Add skill to root README keboola-cli feature list
…ll version to 1.2.0

Rewrite the bulk-write anti-pattern bullet to generic phrasing without a
specific incident count, and bump the skill version to match the plugin.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018RaDiNY9tAYUhuwufpBR9C
…skill

# Conflicts:
#	.claude-plugin/marketplace.json
#	plugins/keboola-cli/.claude-plugin/plugin.json
Adds the Tier 0 required trigger-evals.json for the new
keboola-cli:job-error-triage skill (8 positive / 7 negative cases),
clearing test_every_skill_has_activation_cases. Negatives are hard
boundary cases against sibling skills (debug-component for source-code/
stack-trace/OOM debugging, keboola-config for explain-config, data
analysis, and from-scratch builds).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant