CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

alpaca

Alpaca integration. Manage Organizations, Users, Filters. Use when the user wants to interact with Alpaca data.

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./skills/alpaca/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 highly actionable, with real CLI commands, a connection-state error-recovery loop, and a useful actions catalog. Its weaknesses are background padding that assumes no prior knowledge, a dangling 'Step 2' cross-reference, missing verification for destructive trading operations, and no progressive disclosure — everything lives inline in one file.

Suggestions

Delete the 'what is Alpaca' intro paragraph and the redundant 'Alpaca Overview' bullet list; Claude already knows what Alpaca is, and the actions table covers the same objects.

Number the workflow steps explicitly and fix the 'skip to Step 2' references, which currently point to a section that does not exist.

Add verification steps around destructive/batch trading actions — e.g. after create-order, confirm via get-order that the order was accepted; before cancel-all-orders, list-orders to show the user what will be cancelled.

DimensionReasoningScore

Conciseness

The bulk is efficient, command-focused content, but the opening paragraph ("Alpaca is a commission-free stock brokerage platform... It's used by fintech companies, algorithmic traders...") explains concepts Claude already knows, and the 'Alpaca Overview' bullet list duplicates the popular-actions table — fitting 'mostly efficient but includes some unnecessary explanation.'

3 / 5

Actionability

Concrete, executable commands appear throughout (membrane connection ensure, action list --intent, action run with --input JSON, request proxy with a full flag table) plus a 20-row actions catalog, but the run examples use generic placeholders ('{"key": "value"}') with no worked end-to-end example of a real action, leaving it at 'mostly executable with minor gaps' rather than copy-paste-ready coverage of common cases.

4 / 5

Workflow Clarity

The connection flow has a genuine feedback loop (poll --wait, handle CLIENT_ACTION_REQUIRED, re-poll after user action), but destructive and batch trading actions (create-order, close-position, cancel-all-orders) include no validation/verification steps, which caps workflow clarity at 3 per the rubric guideline; the dangling 'skip to Step 2' references to a nonexistent section further weaken the sequence.

3 / 5

Progressive Disclosure

This is a monolithic single-file skill (~160 lines) with no bundle files and no external references at all; the 25-row actions table is reference material inlined in SKILL.md, matching 'some structure but content that should be separate is inline' — though section headers are clear and there are no nested references.

3 / 5

Total

13

/

20

Passed

Description

62%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 follows the right structure — third-person, a stated capability set, and an explicit 'Use when...' clause — so it clears the completeness bar. Its main weakness is that the listed capabilities (Organizations, Users, Filters) do not match what the skill body actually covers (trading objects like orders, positions, watchlists, assets), and trigger coverage relies solely on the product name.

Suggestions

Replace 'Manage Organizations, Users, Filters' with the objects the skill actually manages — e.g. 'Manage Orders, Positions, Watchlists, Assets, and Account settings for Alpaca trading accounts.'

Broaden trigger terms beyond the product name: 'Use when the user mentions Alpaca, placing stock orders, checking positions or watchlists, or market hours/trading calendar.'

DimensionReasoningScore

Specificity

"Manage Organizations, Users, Filters" names three concrete objects, but the coverage gaps are major — the skill's actual domain (orders, positions, watchlists, assets, account, calendar, clock) is entirely absent from the description, failing the 'minor gaps' bar of anchor 4 while exceeding the minimal/generic actions of anchor 2.

3 / 5

Completeness

Both parts are present: a 'what' ("Alpaca integration. Manage Organizations, Users, Filters.") and an explicit 'when' ("Use when the user wants to interact with Alpaca data"), but the 'when' is generic rather than listing concrete trigger phrases, matching anchor 4 rather than 5; it is explicit, so above anchor 3.

4 / 5

Trigger Term Quality

The only natural trigger term is "Alpaca" (repeated as "Alpaca data") — the product name users would say, but common variations like trading, stock orders, positions, or brokerage are missing, matching 'some relevant keywords but missing common variations or synonyms.'

3 / 5

Distinctiveness Conflict Risk

The named product ("Alpaca") gives a clear niche with minimal conflict risk, but the generic terms "Organizations, Users, Filters" could overlap with unrelated user-management skills, fitting 'mostly distinct; minor overlap risk' rather than anchor 5's concrete distinct triggers.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

membranedev/application-skills

Path

skills/alpaca/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.