CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

debugging-local-task-agent-runs

Debug the output of local PostHog task runs — the wizard cloud-run path that executes inside a Docker sandbox under the local Temporal `process-task` workflow (the wizard that integrates PostHog, then the coding agent that commits and opens the PR). Use when a local run looks stuck, failed, or silent, or when you need to read the wizard or agent logs. Covers the `.env.local` keys + `ai_features` intent required for cloud runs locally, finding the task UUID (docker ps, temporal CLI, Temporal UI at localhost:8081), tailing live logs inside the sandbox container (`/tmp/posthog-wizard.log`, `/tmp/agent-server.log`), and reading the durable per-run console log from object storage after the sandbox is torn down. Trigger terms: task-sandbox, run_wizard, agent-server, process-task, SANDBOX_PROVIDER, LLM_GATEWAY, cloud_run, posthog-wizard.log.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly actionable debugging runbook: every step ships a copy-paste-ready command with expected output, the sequence follows the run lifecycle with clear live-vs-post-teardown branching, and a failure-signatures table provides error recovery. It falls just short of top marks on conciseness (a redundant intro parenthetical) and organization (the env table and error catalog are inline reference material).

Suggestions

Delete the intro parenthetical '(the wizard that integrates PostHog, then the coding agent that commits and opens the PR)' — the numbered list immediately below states the same two stages.

Move the .env.local keys table and the failure-signatures catalog into a references/ file (e.g. references/env-setup.md, references/failure-signatures.md) linked one level deep, keeping SKILL.md as the lean overview.

DimensionReasoningScore

Conciseness

The body is dense with repo-specific detail and explains nothing Claude already knows (no generic Docker/Temporal/Django tutorials), but the intro parenthetical '(the wizard that integrates PostHog, then the coding agent that commits and opens the PR)' restates the numbered list immediately below it, and a few framing sentences ('The hard part of debugging is...', 'This skill is how you actually read it') could be trimmed — matching anchor 4's 'minor instances of over-explanation that could be trimmed' rather than anchor 5's 'every token earns its place'.

4 / 5

Actionability

Every step is copy-paste-ready: 'docker ps --format {{.Names}} | grep task-sandbox', the full 'temporal workflow list --address temporal:7233 --namespace default --limit 10' invocation, 'tail -f' commands with a ready-made grep filter, and a complete 'flox activate' manage.py shell snippet with concrete paths, ports, and expected output comments; the failure-signatures section names exact error strings ('Could not determine cloud region from access token', 'ConnectionRefused') with their fixes.

5 / 5

Workflow Clarity

The workflow is clearly sequenced by run lifecycle (prerequisites → find task UUID → tail live logs 'while it's running' → durable log 'after teardown'), with the branch condition stated in the section headers, a prerequisites checklist ('all of these are set'), expected outputs shown as comments ('# task-sandbox-<TASK_ID>-<suffix>'), an explicit status check in the Step 3 snippet, and a failure-signatures section providing error-to-fix recovery loops — matching anchor 5; the operations are read-only, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The single file is well organized (Prerequisites / Steps 1–3 / Common failure signatures) with no buried or nested references, but at ~110 lines the .env.local keys table and the failure-signature catalog are reference material that could be split into a references/ file to keep SKILL.md a lean overview — a minor organization gap matching anchor 4 rather than anchor 5's ideal content split.

4 / 5

Total

18

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, highly specific description that explicitly states both capabilities and usage triggers with a comprehensive technical trigger-term list. Its only flaw is a second-person clause in the trigger sentence ('when you need to read'), which costs it a point on specificity under the rubric's voice rule.

Suggestions

Rewrite the trigger clause in third person — e.g. 'Use when a local run looks stuck, failed, or silent, or when wizard or agent logs need to be read' — to satisfy the third-person-voice rule that currently costs specificity a point.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage — 'finding the task UUID (docker ps, temporal CLI, Temporal UI at localhost:8081), tailing live logs inside the sandbox container (/tmp/posthog-wizard.log, /tmp/agent-server.log), and reading the durable per-run console log from object storage' — which matches the anchor-5 example; however, the second-person clause 'or when you need to read the wizard or agent logs' violates the third-person-voice rule, so the rubric's mandatory 1-point penalty applies, dropping it to 4.

4 / 5

Completeness

It clearly and explicitly answers both what ('Debug the output of local PostHog task runs... Covers the .env.local keys + ai_features intent... finding the task UUID... tailing live logs... reading the durable per-run console log') and when ('Use when a local run looks stuck, failed, or silent, or when you need to read the wizard or agent logs') with concrete trigger phrases, exactly matching the anchor-5 example.

5 / 5

Trigger Term Quality

The explicit trigger list 'task-sandbox, run_wizard, agent-server, process-task, SANDBOX_PROVIDER, LLM_GATEWAY, cloud_run, posthog-wizard.log' covers the exact identifiers (container names, workflow/activity names, env vars, log filenames) a user debugging this system would naturally say, matching the comprehensive-coverage anchor including file names; it is not score 4 because no obvious natural variation is missing.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — local PostHog task runs inside a Docker sandbox under the Temporal process-task workflow — with distinct triggers (task-sandbox, posthog-wizard.log, run_wizard) that no generic debugging, Docker, or logging skill would match, so conflict risk is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

PostHog/posthog

Path

.agents/skills/debugging-local-task-agent-runs/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.