1Forge integration. Manage data, records, and automate workflows. Use when the user wants to interact with 1Forge data.
32
26%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/1forge/SKILL.mdQuality
Discovery
17%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 description is very weak across all dimensions. It relies entirely on the user knowing the '1Forge' brand name and provides no indication of the domain (forex/currency data), specific capabilities, or meaningful trigger terms. The generic language ('manage data, records, and automate workflows') could apply to almost any integration skill.
Suggestions
Replace generic terms with domain-specific actions, e.g., 'Fetches real-time forex exchange rates, converts currencies, and retrieves market quotes via the 1Forge API.'
Add natural trigger terms users would actually say: 'Use when the user asks about forex rates, currency conversion, exchange rates, market quotes, or references 1Forge.'
Remove filler phrases like 'manage data, records, and automate workflows' that add no distinguishing information and increase conflict risk with other integration skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses vague language like 'manage data, records, and automate workflows' without specifying any concrete actions. It doesn't explain what 1Forge actually does (forex/currency exchange rate data) or what specific operations are available. | 1 / 3 |
Completeness | It has a weak 'what' (manage data, records, automate workflows) and does include a 'Use when' clause, but the trigger is essentially circular ('use when the user wants to interact with 1Forge data'). The 'when' clause doesn't add meaningful guidance beyond restating the skill name. | 2 / 3 |
Trigger Term Quality | The only meaningful trigger term is '1Forge', which is a proper noun. Terms like 'data', 'records', and 'workflows' are extremely generic and would not help distinguish this skill. Missing natural terms users would say like 'forex', 'exchange rates', 'currency conversion', or 'market data'. | 1 / 3 |
Distinctiveness Conflict Risk | The terms 'manage data, records, and automate workflows' are extremely generic and would overlap with virtually any data management or integration skill. Only the '1Forge' brand name provides any distinctiveness, which is insufficient if a user doesn't mention it by name. | 1 / 3 |
Total | 5 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is predominantly generic Membrane CLI documentation with a thin 1Forge veneer. It lacks any 1Forge-specific examples, endpoint paths, or concrete currency conversion/quote workflows. The content is verbose with explanations Claude doesn't need (what forex is, why businesses use it) while missing the actionable, domain-specific guidance that would make it useful.
Suggestions
Remove the introductory paragraph explaining what forex rates are and why businesses use them — Claude already knows this. Cut the content to only what's unique to 1Forge integration.
Add concrete 1Forge-specific examples: actual API endpoint paths (e.g., `/quotes?pairs=EUR/USD`), sample action inputs for currency conversion, and expected output formats.
Extract the generic Membrane CLI setup/authentication/proxy documentation into a shared reference file and keep only 1Forge-specific instructions in this SKILL.md.
Flesh out the '1Forge Overview' section with actual actionable content for Quotes and Convert operations, or remove it if it serves no purpose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The opening paragraph explains what forex rates are and why businesses use them — Claude already knows this. The description of Membrane's auth handling, the explanation of what 'headless environments' are, and the general best practices section all add unnecessary verbosity. Much of the content is generic Membrane CLI usage that isn't specific to 1Forge. | 1 / 3 |
Actionability | The CLI commands are concrete and copy-paste ready (install, login, connection ensure, action list, action run, proxy requests), but there are no 1Forge-specific examples — no actual endpoint paths, no example currency pair queries, no sample input/output for conversion. The skill is almost entirely generic Membrane boilerplate with no actionable 1Forge-specific guidance. | 2 / 3 |
Workflow Clarity | The connection setup flow is reasonably well-sequenced with state handling (READY, BUILDING, CLIENT_ACTION_REQUIRED, errors), but there are no explicit validation checkpoints after running actions. The overall workflow from connection to executing a 1Forge-specific task is implicit rather than clearly laid out as a numbered end-to-end sequence. | 2 / 3 |
Progressive Disclosure | The content has some structure with headers and sections, but it's a monolithic document with no references to supporting files. The '1Forge Overview' section listing 'Quotes', 'Currency Pairs', and 'Convert' is a skeleton that provides no actual content or links. The proxy request options table and generic Membrane instructions could be in separate reference files. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
f484c82
Table of Contents
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.