Name: creating-ai-subscription
Rating: 72 (1 reviews)
Author: PostHog

creating-ai-subscription

Create a recurring AI-generated PostHog report — schedule a free-text prompt to run on a cron, with the LLM-synthesized markdown delivered to email or Slack on each tick. Use when the user wants a recurring AI summary of X on any cadence (daily, weekly, monthly, yearly) rather than a one-off report. (To attach an AI summary to an existing insight/dashboard subscription instead of a free-text prompt, see `managing-subscriptions` and its `summary_enabled` option.)

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

82%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 thorough, highly actionable skill body with executable examples, explicit pre-call gates, and a post-creation verification step. It is slightly verbose in the disambiguation guidance and pitfall prose, and a small amount of edge-case detail could be offloaded to a reference file.

Suggestions

Tighten the 'Prefer a dashboard or insight subscription first' blockquote and the re-enable pitfall to their decision-relevant essentials to reduce token load.

Consider moving the transient-vs-permanent failure and re-enable-precondition detail into a short reference file linked from Pitfalls, keeping the inline version to the rule of thumb.

Add an explicit 'if the create call returns 400, check the three gates in order before retrying' recovery loop to raise workflow clarity.

Dimension	Reasoning	Score
Conciseness	Mostly lean and assumes Claude's competence (no explaining of PostHog/cron/HogQL basics), but the 'Prefer a dashboard or insight subscription first' blockquote and the re-enable pitfall prose run long and could be trimmed.	4 / 5
Actionability	Provides a concrete tool table, fully specified required/optional argument YAML, a three-step Slack-target procedure with named tools, and two copy-paste-ready example YAML blocks covering the common email and Slack cases.	5 / 5
Workflow Clarity	Clear sequence from pre-call gates through args, Slack setup, creation, and an 'After it lands' verification checklist, with explicit stop-on-failure feedback ('If any of the three is missing, stop ... re-calling will not help'); a fully realized error-recovery loop would push it to 5.	4 / 5
Progressive Disclosure	Well-organized into clearly headed sections with one-level-deep, clearly signaled pointers to related skills (`managing-subscriptions`, `building-a-dashboard`) and no nested references; some Pitfalls detail (re-enable preconditions, transient-vs-permanent failure semantics) is dense enough that it could optionally live in a reference file.	4 / 5
	Total	17 / 20 Passed

Description

92%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 precise, well-scoped description that names concrete actions, gives an explicit 'Use when' trigger with natural phrasing, and cleanly separates this skill from the related subscription-management skill. Only minor synonym coverage is missing in the trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Create a recurring AI-generated PostHog report', 'schedule a free-text prompt to run on a cron', 'LLM-synthesized markdown delivered to email or Slack on each tick' — with comprehensive coverage of what the skill does.	5 / 5
Completeness	Explicitly answers both 'what' (create a recurring AI-generated report delivered to email/Slack) and 'when' via the concrete 'Use when the user wants a recurring AI summary of X on any cadence ... rather than a one-off report' trigger clause.	5 / 5
Trigger Term Quality	Strong natural phrasings like 'recurring AI summary of X', 'daily, weekly, monthly, yearly', 'one-off report', and 'email or Slack' map to what users say; a few synonyms (e.g. 'scheduled digest', 'recurring report') are absent, keeping it just short of comprehensive.	4 / 5
Distinctiveness Conflict Risk	Clear niche — a recurring AI prompt subscription in PostHog — explicitly disambiguated from insight/dashboard subscriptions and pointed to `managing-subscriptions`, minimizing overlap with sibling skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: products/subscriptions/skills/creating-ai-subscription/SKILL.md
Commit: 57503b8

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

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.