usfiscaldata

Query the U.S. Treasury Fiscal Data API for federal financial data including national debt, government spending, revenue, interest rates, exchange rates, and savings bonds. Access 54 datasets and 182 data tables with no API key required. Use when working with U.S. federal fiscal data, national debt tracking (Debt to the Penny), Daily Treasury Statements, Monthly Treasury Statements, Treasury securities auctions, interest rates on Treasury securities, foreign exchange rates, savings bonds, or any U.S. government financial statistics.

Quality

86%

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

Quality

Content

72%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-structured, mostly executable API reference with excellent progressive disclosure through eight clearly labeled reference files. Weakest in workflow clarity: the read/query patterns lack explicit error-handling and validation checkpoints, and one named helper does not do what its name implies.

Suggestions

Fix or rename fetch_all_pages: either implement an actual pagination loop over meta["total-pages"] / links["next"], or rename it to fetch_page to avoid misleading users.

Add a validation checkpoint to the common patterns — e.g. resp.raise_for_status() after each requests.get(...) with guidance to retry/back off on 429/5xx.

Drop the redundant intro sentence that restates the description ("Free, open REST API... No API key or registration required") to tighten the token budget.

Dimension	Reasoning	Score
Conciseness	Mostly lean and table-driven with executable code; minor redundancy such as the intro line ("Free, open REST API... No API key or registration required") restating the description, and a few table cells that could be trimmed.	4 / 5
Actionability	Provides copy-paste Quick Start code, a parameters table with concrete examples, and specific endpoints per dataset; the "Load all pages into a DataFrame" helper is misleadingly named since it fetches only a single page rather than looping, a minor gap.	4 / 5
Workflow Clarity	Usage patterns (build params, GET, parse) are clear, but code examples omit validation checkpoints such as status-code checks or raise_for_status(), and there is no error-recovery guidance for failed requests.	3 / 5
Progressive Disclosure	SKILL.md is a clear overview with a well-signaled "Reference Files" section linking to eight one-level-deep references (all verified present: api-basics, parameters, datasets-debt/fiscal/interest-rates/securities, response-format, examples), each labeled with its contents.	5 / 5
	Total	16 / 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.

An exemplary description: concise yet comprehensive, with concrete capabilities, a rich set of natural trigger terms, and an explicit 'Use when' clause tied to specific Treasury datasets and reports. Third-person voice is maintained throughout.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete data categories ("national debt, government spending, revenue, interest rates, exchange rates, and savings bonds") plus concrete actions ("Query the U.S. Treasury Fiscal Data API", "Access 54 datasets and 182 data tables"), giving comprehensive coverage of the domain.	5 / 5
Completeness	Explicitly answers both what ("Query the U.S. Treasury Fiscal Data API for federal financial data...") and when ("Use when working with U.S. federal fiscal data...") with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	The "Use when..." clause spans natural terms and synonyms users would say — "national debt tracking (Debt to the Penny)", "Daily Treasury Statements", "Monthly Treasury Statements", "Treasury securities auctions", "foreign exchange rates", "savings bonds", and "U.S. government financial statistics".	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (U.S. Treasury fiscal data) with distinct, domain-specific triggers; minimal risk of firing for unrelated skills.	5 / 5
	Total	20 / 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
metadata_version	'metadata.version' is missing	Warning

	Total	15 / 16 Passed

Repository: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/usfiscaldata/SKILL.md
Commit: d5ae560

Reviewed: 1 day 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.