skill-idea-miner

Mine Claude Code session logs for skill idea candidates. Use when running the weekly skill generation pipeline to extract, score, and backlog new skill ideas from recent coding sessions.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/skill-idea-miner/SKILL.md

Quality

Content

68%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.

The body is lean and actionable with executable commands and concrete output examples, structured well with one-level-deep references to real bundle files. The batch pipeline workflow lacks explicit validation/verification checkpoints, which caps workflow clarity.

Suggestions

Add an explicit validation checkpoint between Stage 1 and Stage 2 (e.g. verify raw_candidates.yaml schema/counts before scoring) and a final verification of the merged backlog.

Trim the opening paragraph that restates the frontmatter description to improve token efficiency.

Dimension	Reasoning	Score
Conciseness	Mostly lean procedural content with executable commands and YAML examples; minor padding (intro paragraph restates the description) but overall efficient.	4 / 5
Actionability	Provides concrete executable commands (python3 scripts/...), specific CLI flags (--dry-run, --output-dir), and complete YAML output examples with minor gaps in argument detail.	4 / 5
Workflow Clarity	Two-stage workflow is well sequenced, but this is a batch/pipeline operation over session logs with no explicit validation or verification checkpoints between stages, capping clarity at 3 per the destructive/batch rule.	3 / 5
Progressive Disclosure	Clear overview with a Resources section pointing one level deep to a real references file and two scripts; bulk logic is offloaded to scripts, with only minor signaling gaps.	4 / 5
	Total	15 / 20 Passed

Description

67%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.

The description clearly states what the skill does and when to use it, with concrete actions and a distinct niche trigger. Trigger terms lean toward pipeline-specific jargon and could use broader natural phrasings.

Suggestions

Add broader natural trigger phrases a user would say (e.g. 'find skill ideas', 'review session logs for reusable skills') alongside the pipeline-specific wording.

Broaden the 'Use when...' clause to cover manual or ad-hoc backlog refresh scenarios, not only the weekly pipeline run.

Dimension	Reasoning	Score
Specificity	Lists concrete actions ('extract, score, and backlog') and the data source ('session logs'), naming the domain and multiple specific operations with minor gaps in coverage.	4 / 5
Completeness	Clearly states what it does and includes an explicit 'Use when running the weekly skill generation pipeline...' trigger, though the when-clause is a single specific scenario rather than broad triggers.	4 / 5
Trigger Term Quality	'skill idea candidates' and 'skill generation pipeline' are relevant but niche jargon; common natural phrasings a user would say (e.g. 'skill ideas', 'find skills') are partially present, missing broader synonyms.	3 / 5
Distinctiveness Conflict Risk	Niche purpose (mining session logs for skill ideas) with distinct triggers tied to a pipeline, giving minimal overlap risk with general skills.	4 / 5
	Total	15 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: tradermonty/claude-trading-skills
Path: skills/skill-idea-miner/SKILL.md
Commit: 51c7907

Reviewed: ~6 hours 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.