CtrlK
BlogDocsLog inGet started
Tessl Logo

building-workflows

Build, edit, test, enable, and monitor PostHog workflows over MCP. Author the action/edge graph so it runs and opens cleanly in the visual editor, then change drafts surgically with patch operations. Use when asked to build, set up, automate, change, fix, or debug a workflow, campaign, broadcast, drip sequence, or event-triggered automation in the workflows product.

80

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%

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

A tightly written, highly actionable skill body: it assumes Claude's competence, gives concrete MCP tool calls with parameters and a complete worked example, sequences the lifecycle with explicit validation and error-recovery loops, and splits detail into two clearly-signaled reference files. No notable weaknesses.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational detail (server-owned bytecode/trigger derivation, patch semantics, draft staging, in-flight run behavior, timing-edit sweep, rollback limits) and never explains concepts Claude already knows; every sentence carries operational weight, matching the 'lean and efficient; every token earns its place' anchor.

3 / 3

Actionability

It names specific MCP tools with concrete parameters (workflows-patch-graph, workflows-test-run with current_action_id/use_draft=true, workflows-publish with confirm=true/confirm_token, mock_async_functions=false) and includes a complete, copy-paste-ready worked JSON graph, matching the 'fully executable' top anchor.

3 / 3

Workflow Clarity

An explicit 8-step lifecycle is sequenced with validation checkpoints — 'Every edit invalidates your earlier test — re-run the affected path', user sign-off before enable, and a publish cycle with impact preview → confirm_token → 409/400 error recovery — matching the 'clear sequence with explicit validation steps; feedback loops' anchor.

3 / 3

Progressive Disclosure

The body is an overview that signals two real, one-level-deep leaf references — references/graph-schema.md ('the contract') and references/lifecycle-and-debugging.md ('grouped by job'), both confirmed to exist — with no nested reference chains, matching the 'clear overview with well-signaled one-level-deep references' anchor.

3 / 3

Total

12

/

12

Passed

Description

100%

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, third-person description that states concrete capabilities and pairs them with an explicit, naturally-worded 'Use when' trigger clause scoped to PostHog workflows. It answers both what the skill does and when to invoke it with minimal fluff.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Build, edit, test, enable, and monitor PostHog workflows over MCP', 'Author the action/edge graph', 'change drafts surgically with patch operations' — matching the 'lists multiple specific concrete actions' anchor rather than the partial 'names domain and some actions' level below.

3 / 3

Completeness

It explicitly answers both 'what' (build/edit/test/enable/monitor workflows over MCP, author the graph, patch drafts) and 'when' via an explicit 'Use when asked to...' trigger clause, matching the top anchor.

3 / 3

Trigger Term Quality

The 'Use when' clause enumerates natural phrasings a user would actually say — 'build, set up, automate, change, fix, or debug a workflow, campaign, broadcast, drip sequence' — giving good coverage, not just a single keyword as at level 2.

3 / 3

Distinctiveness Conflict Risk

Scoped to 'PostHog workflows over MCP' / 'the workflows product' with distinct marketing-automation triggers (campaign, broadcast, drip sequence, event-triggered automation), giving it a clear niche unlikely to conflict; not generic like the level-1 'helps with code and documents'.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
PostHog/posthog
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.