CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

usfiscaldata

Queries the U.S. Treasury Fiscal Data REST API for federal financial data. No API key required. Use for national debt (Debt to the Penny), Daily Treasury Statements, Monthly Treasury Statements, Treasury securities auctions, interest rates, foreign exchange rates, savings bonds, or U.S. government revenue and spending statistics.

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

92%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 well-engineered API skill body: executable examples with error handling, exact endpoint paths, domain-specific interpretation caveats, and a clean one-level-deep reference structure verified against the actual bundle. Its only flaw is minor token redundancy around authentication notes and inline dated provenance.

Suggestions

Consolidate the authentication message: drop the dedicated '## Authentication' section (or the intro sentence) since the frontmatter already states 'No API key required' — one mention in the body suffices.

Move the review-provenance sentence ('Reviewed against the official API guide ... on 2026-09-30') into a reference file or the frontmatter metadata to keep dated, time-sensitive statements out of the always-loaded body.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — no explanation of REST, requests, or pandas basics, and the endpoint tables and interpretation checks are Treasury-specific knowledge that earns its tokens. Minor trimmable instances remain: the no-API-key point appears in both the intro ("No API key or registration required") and a dedicated Authentication section, and the dated review-provenance sentence ("Reviewed against ... on 2026-09-30") sits inline rather than in a reference. This places it between the lean anchor 5 and the minor-trim anchor 4, closer to 4.

4 / 5

Actionability

Quick-start code is fully executable and copy-paste ready (requests.get with timeout, raise_for_status, JSON parsing), the parameter table gives exact syntax with examples, endpoint tables list precise paths, and the single-page pattern includes a runtime guard (raise ValueError if total-pages > 1) with the multi-page fetch_all helper verified to exist in references/parameters.md. This matches the fully-executable anchor 5.

5 / 5

Workflow Clarity

For a simple read-only query skill the single action is unambiguous (base URL + endpoint path + params), and the body nonetheless includes explicit validation checkpoints: resp.raise_for_status(), the total-pages check before assuming single-page results, and the instruction to inspect full row grain before relying on field selection. No destructive or batch operations exist, so no cap applies — this fits the simple-skill exception for a 5.

5 / 5

Progressive Disclosure

SKILL.md is a clear overview (quick start, parameter summary, key endpoint tables) with eight well-signaled one-level-deep reference files, all verified to exist on disk, each linked with markdown paths and one-line scope descriptions in the Reference Files section plus inline links where relevant. This matches the anchor-5 pattern of a concise overview pointing to one-level-deep references.

5 / 5

Total

19

/

20

Passed

Description

87%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 strong description: it states the concrete capability, flags that no API key is needed, and provides an explicit 'Use for' clause with a comprehensive list of dataset-specific trigger terms in third-person voice. The only weakness is reliance on a single action verb, leaving specificity and trigger coverage just short of comprehensive.

DimensionReasoningScore

Specificity

"Queries the U.S. Treasury Fiscal Data REST API for federal financial data" names the concrete system, and the description enumerates specific data domains ("national debt (Debt to the Penny), Daily Treasury Statements, Monthly Treasury Statements, Treasury securities auctions, interest rates, foreign exchange rates, savings bonds"). It lists several specific capabilities with only a minor gap — a single action verb ("Queries") rather than multiple distinct actions — so it fits anchor 4 better than the multi-action anchor 5 and well above the 1-2-action anchor 3.

4 / 5

Completeness

The "what" is explicit ("Queries the U.S. Treasury Fiscal Data REST API for federal financial data. No API key required.") and the "when" is explicit with concrete trigger phrases ("Use for national debt (Debt to the Penny), Daily Treasury Statements, ... or U.S. government revenue and spending statistics."), which matches the anchor-5 example structure of clear what + explicit 'Use when' triggers. It is not a 4 because neither half is weakly implied.

5 / 5

Trigger Term Quality

Natural user phrases like "national debt", "interest rates", "foreign exchange rates", "savings bonds", and "U.S. government revenue and spending" are exactly what a user would say. Coverage is good but a few natural synonyms are missing (e.g., "federal deficit", "Treasury data", "TGA"), matching anchor 4 rather than the comprehensive-synonym anchor 5.

4 / 5

Distinctiveness Conflict Risk

The U.S. Treasury fiscal-data niche is unmistakable — dataset-specific terms like "Debt to the Penny", "Monthly Treasury Statements", and "Treasury securities auctions" give it a clear niche with distinct triggers and minimal conflict risk with other skills, matching anchor 5.

5 / 5

Total

18

/

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

K-Dense-AI/scientific-agent-skills

Path

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