CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vcp-screener

Screen S&P 500 stocks for Mark Minervini's Volatility Contraction Pattern (VCP) and detect historical VCPs in a single ticker's price path. Identifies Stage 2 uptrend stocks forming tight bases with contracting volatility near breakout pivot points; in historical single-ticker mode walks a multi-year history and emits every VCP that formed with forward-outcome stats (breakout / stop-hit / timeout). Use when user requests VCP screening, Minervini-style setups, tight base patterns, volatility contraction breakout candidates, Stage 2 momentum stock scanning, or historical VCP pattern study on a specific ticker (e.g. FIX, TSLA).

Quality

92%

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

80%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 strong, command-driven skill body: fully executable invocations with complete parameter documentation and excellent progressive disclosure into real, one-level reference files. The main gap is the absence of validation/error-recovery steps for a rate-limit-prone batch pipeline, which caps workflow clarity; minor duplication of the frontmatter in the intro and When to Use sections costs some token efficiency.

Suggestions

Add a validation checkpoint after the screening run: verify the timestamped output files (vcp_screener_*.json/.md) were created and contain candidates before presenting analysis, with a fix path if the run failed.

Add error-recovery guidance for FMP rate limits (e.g., free tier's 250 calls/day vs. the pipeline's ~201 calls; what to do on a 429 or partial run — retry, reduce universe, or resume from the last completed ticker).

Trim the duplicated content between the frontmatter description, the intro line, and the When to Use section to reclaim context tokens.

DimensionReasoningScore

Conciseness

The body is dense and tool-specific (commands, flag tables, notes on API costs and dedup) with no explanation of concepts Claude already knows — VCP theory is correctly deferred to references. However, the intro line ("Screen S&P 500 stocks for Mark Minervini's VCP, identifying Stage 2 uptrend stocks with contracting volatility...") and the "When to Use" bullets largely duplicate the frontmatter description, so a few sections could be trimmed — the anchor-4 "minor instances that could be trimmed" rather than anchor-5's "every token earns its place".

4 / 5

Actionability

Every mode has copy-paste-ready bash invocations with concrete flags: default screening, custom universe, --full-sp500, --strict, three historical-mode variants, and advanced tuning, supplemented by parameter tables giving defaults and valid ranges (e.g. "--min-contractions | 2 | 2-4"). This covers all common cases exactly as the anchor-5 example does.

5 / 5

Workflow Clarity

The four-step sequence (run → review results → present analysis → actionable guidance) is clear and the execution-state/rating decision tables are excellent, but there are no validation or error-recovery checkpoints. This is a batch operation (~101+100 API calls per the 3-Phase Pipeline against a 250-call/day free tier, so quota exhaustion mid-run is a realistic failure), and the rubric caps workflow_clarity at 3 for batch operations missing validate/fix/retry loops — e.g., verifying the timestamped output files were created before presenting, or handling FMP rate-limit errors.

3 / 5

Progressive Disclosure

The body is a proper overview: methodology, scoring thresholds, and API endpoints live in the three referenced files (all present in the bundle, one level deep), signaled both in Step 2 and in a Resources section. The inline content (commands, flag tables) is operational and belongs in SKILL.md, so the split is appropriate and navigation is easy — matching the anchor-5 example structure.

5 / 5

Total

17

/

20

Passed

Description

100%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 model description: concrete two-mode capability statement in third person, an explicit "Use when..." clause with a rich set of natural domain synonyms and example tickers, and a clearly distinct Minervini/VCP niche with minimal conflict risk. Slight redundancy between the first two sentences keeps it dense but not padded.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering both modes comprehensively: "Screen S&P 500 stocks", "detect historical VCPs in a single ticker's price path", "Identifies Stage 2 uptrend stocks forming tight bases with contracting volatility near breakout pivot points", and "emits every VCP that formed with forward-outcome stats (breakout / stop-hit / timeout)". This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the score-4 anchor of minor gaps.

5 / 5

Completeness

It explicitly answers both questions: the "what" (two-sentence capability description of screening and historical detection with forward-outcome stats) and the "when" ("Use when user requests VCP screening, Minervini-style setups...") with concrete trigger phrases. This is a direct match for the anchor-5 example structure; a 4 would need a less explicit "when" clause.

5 / 5

Trigger Term Quality

"VCP screening, Minervini-style setups, tight base patterns, volatility contraction breakout candidates, Stage 2 momentum stock scanning, or historical VCP pattern study on a specific ticker (e.g. FIX, TSLA)" comprehensively covers the natural synonyms a user would say for this niche, including concrete example tickers. No natural term within the domain is missing; score 4 would require identifiable gaps, which there aren't.

5 / 5

Distinctiveness Conflict Risk

The niche is unambiguous — Mark Minervini's VCP, Stage 2, volatility contraction — with triggers anchored in that domain, so risk of firing for an unrelated skill is minimal. Generic-sounding fragments like "tight base patterns" are always bound to the VCP/Minervini context, keeping it above the score-4 "minor overlap risk" anchor.

5 / 5

Total

20

/

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

tradermonty/claude-trading-skills

Path

skills/vcp-screener/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.