one-step-better-ai-pm
Get one actionable improvement for your AI product based on the latest GenAI PM briefs. Fetch the last 5 days of curated AI PM insights from genaipm.com, analyze the current repo/project, find synergy between trending topics and the user's work, then research the source material and apply a concrete improvement. Use when the user wants to improve their AI product, get coaching on AI PM best practices, apply the latest industry insights to their codebase, or run "/one-step-better-ai-pm". Requires a GenAI PM subscriber email (set GENAIPM_EMAIL env var or provide when prompted).
90
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
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.
This is a well-crafted skill description that excels across all dimensions. It provides specific concrete actions, includes natural trigger terms users would say, has an explicit 'Use when...' clause with multiple scenarios, and is highly distinctive with its specific domain focus and unique command trigger. The inclusion of requirements (email env var) adds helpful context.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Fetch the last 5 days of curated AI PM insights', 'analyze the current repo/project', 'find synergy between trending topics', 'research the source material', and 'apply a concrete improvement'. Uses third person voice correctly. | 3 / 3 |
Completeness | Clearly answers both what (fetch insights, analyze repo, find synergy, apply improvement) AND when with explicit 'Use when...' clause covering multiple trigger scenarios. Also includes requirements information about the email env var. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'improve their AI product', 'AI PM best practices', 'industry insights', 'codebase', and the explicit command '/one-step-better-ai-pm'. Good coverage of variations. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific niche: GenAI PM insights from genaipm.com, the unique command '/one-step-better-ai-pm', and the specific GENAIPM_EMAIL requirement. Unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent workflow clarity and actionability. The multi-phase structure with an explicit approval gate is a strong pattern for skills that make changes. The main weaknesses are moderate verbosity (some explanatory text and exhaustive lists could be trimmed) and the monolithic structure that could benefit from splitting detailed reference material into separate files.
Suggestions
Trim the AI SDK grep list to 3-4 examples with '...etc' rather than listing 10+ specific imports
Consider extracting the 4-dimension repo profile template and scoring criteria into a separate reference file to reduce SKILL.md length
Remove explanatory phrases like 'This profile drives relevancy matching in Phase 3' that Claude can infer from context
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy (e.g., the grep examples list many AI SDKs that could be shortened, and some explanatory text like 'This profile drives relevancy matching' adds little value). The workflow is detailed but could be tightened in places. | 2 / 3 |
Actionability | Provides concrete, executable guidance throughout: specific API endpoint with URL pattern, exact file paths to check, specific grep targets, JSON schema for history tracking, and clear examples of what improvements look like. Copy-paste ready where it matters. | 3 / 3 |
Workflow Clarity | Excellent multi-phase workflow with explicit approval gate ('Do NOT proceed to Phase 4 without explicit user approval'), clear sequencing, validation steps (check history.json to skip duplicates), and error handling (401 response guidance). The 5 phases are logically ordered with clear dependencies. | 3 / 3 |
Progressive Disclosure | Content is well-structured with clear phases and sections, but everything is inline in a single file. For a skill of this complexity (~150 lines), some content could be split out (e.g., the scoring criteria, the repo profile dimensions, or example improvements). No external references are provided. | 2 / 3 |
Total | 10 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- menkesu/awesome-pm-skills
- Commit
53530ef
- 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.