# Tools bulk import

Use **Admin → Tools → Download tools bulk ZIP template**. Ask AI to generate declarative tool JSON using `AI-TOOLS-INSTRUCTIONS.txt`, then validate and import the returned ZIP.

Supported tool engines are:

- `grade_calculator`: fields named `earned` and `total`, with an optional `grade_scale`.
- `percentage_calculator`: fields named `value` and `total`.
- `unit_converter`: fields named `value`, `from`, and `to`, plus a `units` map whose entries contain `factor`, optional `offset`, and `symbol`.
- `date_countdown`: a date field named `target_date`.
- `study_timer`: a number field named `minutes` from 1 through 240.

Tool slugs begin `tools/`; categories use `tool_category`. The importer blocks executable code. The shared built-in JavaScript engine runs calculations in the visitor's browser. Each tool must also include substantial visible instructions, an example, assumptions and limitations so its page remains useful and indexable content rather than a thin utility.

Published indexable tools appear automatically on `/tools`, applicable categories, search, homepage Study Tools sections, and `sitemap-tools.xml`.
