How do I install the Data Import Workflow skill?

Run npx skillmds add majiayu000/data-import-workflow in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Data Import Workflow safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Data Import Workflow?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Data Import Workflow free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Data Import Workflow?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Data Import Workflow by majiayu000 — Agent Skill

Name: Data Import Workflow
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

File contents

Data Import Workflow Skill

Use this skill when working on or running the data import pipeline.

Scope

Running the importer to populate or refresh data
Extending the importer to handle new fields or types
Debugging import failures

Running the Importer

Command	Use Case
`task importer:start`	Fetch fresh data from tarkov.dev API and update the database.
`task importer:start:use-cache`	Use locally cached JSON files (faster, avoids API rate limits).
`task importer:start:cache-only`	Fetch from API and update local cache, but skip database writes.

Import Behavior

Purge: Existing weapons, mods, trader offers, and optimum builds are deleted.
Fetch: Data is retrieved from tarkov.dev GraphQL API (or local cache).
Transform: External schema is mapped to internal models structs.
Persist: Data is written to the database within a transaction.
Invalidate: optimum_builds are purged since they depend on the imported data.

Extending the Importer

When adding new fields or types:

Update GraphQL Query: Modify internal/tarkovdev/schemas/queries.graphql.
Regenerate Client: Run task tarkovdev:regenerate.
Update Models: Add new fields to structs in internal/models/.
Update Mapping: Adjust conversion logic in internal/importers/.
Update SQL: Modify Upsert functions in internal/models/ to include new columns.

Troubleshooting

Rate Limiting: Use --use-cache for repeated runs during development.
Schema Mismatch: Run task tarkovdev:get-schema then task tarkovdev:regenerate.
Connection Issues: Verify POSTGRES_HOST in .env and ensure the database is running.

---name: data-import-workflowdescription: Managing the lifecycle of weapon and mod data from external sources to the local database--- # Data Import Workflow Skill Use this skill when working on or running the data import pipeline. --- ## Scope - Running the importer to populate or refresh data - Extending the importer to handle new fields or types - Debugging import failures --- ## Running the Importer | Command | Use Case | |---------|----------| | `task importer:start` | Fetch fresh data from tarkov.dev API and update the database. | | `task importer:start:use-cache` | Use locally cached JSON files (faster, avoids API rate limits). | | `task importer:start:cache-only` | Fetch from API and update local cache, but skip database writes. | --- ## Import Behavior 1. **Purge**: Existing weapons, mods, trader offers, and optimum builds are deleted. 2. **Fetch**: Data is retrieved from tarkov.dev GraphQL API (or local cache). 3. **Transform**: External schema is mapped to internal `models` structs. 4. **Persist**: Data is written to the database within a transaction. 5. **Invalidate**: `optimum_builds` are purged since they depend on the imported data. --- ## Extending the Importer When adding new fields or types: 1. **Update GraphQL Query**: Modify `internal/tarkovdev/schemas/queries.graphql`. 2. **Regenerate Client**: Run `task tarkovdev:regenerate`. 3. **Update Models**: Add new fields to structs in `internal/models/`. 4. **Update Mapping**: Adjust conversion logic in `internal/importers/`. 5. **Update SQL**: Modify `Upsert` functions in `internal/models/` to include new columns. --- ## Troubleshooting - **Rate Limiting**: Use `--use-cache` for repeated runs during development. - **Schema Mismatch**: Run `task tarkovdev:get-schema` then `task tarkovdev:regenerate`. - **Connection Issues**: Verify `POSTGRES_HOST` in `.env` and ensure the database is running.

Frequently asked questions