add-data-source

Scaffolds new Israeli public data source modules with OpenSpec proposals and Mastra agent registration.

130|14|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/LiorVainer/data-israel --skill add-data-source-liorvainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-data-source
Source: https://github.com/LiorVainer/data-israel/tree/main/.claude/skills/add-data-source
Command: npx skills add https://github.com/LiorVainer/data-israel --skill add-data-source-liorvainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding a new government or public data API to the Data Israel agent network requires touching many files—API clients, Mastra tools, agent factories, registries, translations, CSS badges, and tests. This Skill guides the full process so nothing is missed and every module follows the project's DataSourceDefinition pattern. ## Core Features & Use Cases - Structured Requirements Gathering: Walks through grouped questions covering API identity, authentication, architecture pattern (standalone vs. subfolder), agent delegation, and tool definitions. - Proxy Tier Classification: Runs a classification script against the upstream API from a non-Israeli egress to decide whether Bright Data residential or Web Unlocker proxying is required. - OpenSpec Proposal Scaffolding: Creates proposal.md, design.md, tasks.md, and spec files under openspec/changes/ before any code is written. - End-to-End Implementation & Registration: Generates the API client, Zod-schema tools, Hebrew agent instructions, translations, registry wiring, and API validation contract tests. - Use Case: You want to add a transportation data API to the platform. The Skill interviews you about the endpoint, classifies its proxy needs, drafts the OpenSpec change, implements all files, registers the agent, and verifies with tsc, build, and live API tests. ## Quick Start Ask the agent to add a new data source for the Israeli public transportation API and follow its guided workflow.

Frequently Asked Questions about add-data-source

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new data source to the Data Israel agent network?

Follow the guided workflow: answer structured questions about the API, run the proxy classification script, create an OpenSpec proposal, implement files following the DataSourceDefinition pattern, register in the registry and types, then verify with tsc, build, and contract tests.

How do I decide between a standalone data source and a subfolder?

Use a standalone folder under src/data-sources/ for a single API with its own agent, like cbs or knesset. Use a subfolder under an existing source, like health/tools/drugs/, when adding a new domain to a multi-layer source; subfolders skip registry and DataSource type changes.

Why does the skill test APIs from a non-Israeli IP address?

Some Israeli APIs geo-block, return HTML fallbacks, or silently empty results for non-Israeli egress like Vercel's default regions. The classify-source script uses a Bright Data probe URL forced outside Israel to determine whether the source needs a residential or Web Unlocker proxy tier.

Does the skill support MCP-based data sources?

Yes. If the source uses an MCP endpoint instead of custom tools, tools are auto-discovered via MCPClient.listTools() rather than defined manually with Zod schemas, as done for the budget data source.

What tests are required after implementing a new data source?

Create an API validation test file that calls each tool's execute() with real API inputs and validates results against the declared outputSchema. Use one test per tool with 30s timeouts, minimal inputs, and describe.sequential; both success and error responses count as valid.