# Send FRED-Navigator to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "fred-navigator", "name": "FRED-Navigator", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/kiszly/fred-navigator", "canonicalUrl": "https://clawhub.ai/kiszly/fred-navigator", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/fred-navigator", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fred-navigator", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "requirements.txt", "README.md", "SKILL.md", "scripts/build_paths.py", "scripts/fred_query.py", "references/category_paths.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "fred-navigator", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-03T03:10:45.425Z", "expiresAt": "2026-05-10T03:10:45.425Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fred-navigator", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fred-navigator", "contentDisposition": "attachment; filename=\"fred-navigator-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "fred-navigator" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/fred-navigator" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/fred-navigator", "downloadUrl": "https://openagent3.xyz/downloads/fred-navigator", "agentUrl": "https://openagent3.xyz/skills/fred-navigator/agent", "manifestUrl": "https://openagent3.xyz/skills/fred-navigator/agent.json", "briefUrl": "https://openagent3.xyz/skills/fred-navigator/agent.md" } } ``` ## Documentation ### Purpose Provide a reliable workflow to navigate FRED categories and series, with support for: Direct category_id Direct series_id Natural-language query → intent recognition → double validation ### Inputs category_id: FRED category id series_id: FRED series id query: natural language request limit: number of candidates to return (default 5) api_key: read from environment FRED_API_KEY only ### Required Resources references/fred_categories_tree.json references/fred_categories_flat.json Optional: references/category_paths.json (precomputed) Optional: references/synonyms.json Helper script: scripts/fred_query.py Path builder: scripts/build_paths.py ### Optional Resource Structure Notes references/category_paths.json format: { "category_id": { "id": , "name": "", "path": "" }, ... } references/synonyms.json format: { "concept": ["alias1", "alias2", ...], ... } ### 1. Category Exploration Load fred_categories_tree.json for hierarchical browsing. If user provides category_id, validate it exists. If user provides category_name, fuzzy match against flat names and return candidates. ### 2. Series Discovery Use search_by_category(category_id) to list available series. Prefer scripts/fred_query.py category for consistent output. Return key columns: id, title, frequency, units, seasonal_adjustment, last_updated. ### 3. Series Retrieval Use get_series(series_id) for time series. Use get_series_info(series_id) for metadata. Prefer scripts/fred_query.py series and scripts/fred_query.py series-info . Provide: data head/tail missing counts latest value and date ### 4. Natural Language Query 4.1 Intent Identification (Top-K) Use the IDE agent (Codex) to interpret the natural-language intent. Select the single best-matching category. If confidence is low, ask the user to confirm the category before proceeding. Use references/category_paths.json and references/synonyms.json as supporting context if available. 4.2 Double Validation Structural validation Candidate must exist in fred_categories_tree.json. Pass if at least one: children non-empty search_by_category(id) returns >= 1 series Prefer scripts/fred_query.py check-category for a quick check Semantic validation (agent) Compare query with candidate name/path. Return pass/fail or numeric relevance score. 4.3 Decision If structural + semantic validation both pass → accept category. Otherwise: return Top-5 candidates ask user to choose one explicitly ### Failure Handling Always provide Top-5 candidates when uncertain. Never proceed to series retrieval if category validation fails. ### Notes Do not hardcode API keys. Keep heavy reference data in references/, not in this file. When running Python functions for querying, execute them inside the sandbox environment. ### Maintenance Update workflow or constraints: edit SKILL.md. Update category data: replace files in references/. Improve natural-language matching: add or edit references/synonyms.json (key → list of related terms). Regenerate precomputed paths (optional): run scripts/build_paths.py. Add helper scripts (optional): place in scripts/ and document usage here. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: kiszly - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-03T03:10:45.425Z - Expires at: 2026-05-10T03:10:45.425Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/fred-navigator) - [Send to Agent page](https://openagent3.xyz/skills/fred-navigator/agent) - [JSON manifest](https://openagent3.xyz/skills/fred-navigator/agent.json) - [Markdown brief](https://openagent3.xyz/skills/fred-navigator/agent.md) - [Download page](https://openagent3.xyz/downloads/fred-navigator)