# Edubase Edu Writer

> >

- **Type:** Skill
- **Install:** `agentstack add skill-edubase-skills-edubase-edu-writer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [EduBase](https://agentstack.voostack.com/s/edubase)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [EduBase](https://github.com/EduBase)
- **Source:** https://github.com/EduBase/skills/tree/main/edubase-edu-writer

## Install

```sh
agentstack add skill-edubase-skills-edubase-edu-writer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# EduBase EDU File Writer

EDU files are single-question text files for one-by-one upload to EduBase Quizzing.
This skill handles **format and serialization** — for question content rules, types, operators,
and field semantics, use the `edubase-question-creator` skill alongside this one.

---

## EDU File Format — Rules

### Section headers
Every field is wrapped in a header/footer pair:
```
%------FIELDNAME------%
value goes here
```

### Mandatory fields (marked `!!`)
```
%------QUESTION!!------%
%------ANSWER!!------%
%------TYPE!!------%
```
If QUESTION or ANSWER is empty → entire file is skipped on upload.

### Recommended fields (marked `!`)
```
%------SUBJECT!------%
%------CATEGORY!------%
```

### Checkbox fields
Some fields present options as checkboxes. Mark exactly one with `[X]`, rest stay `[ ]`:
```
% [X] CHOICE
% [ ] MULTIPLE-CHOICE
```
For TYPE, mark **exactly one** type. For SUBSCORING, MANUAL_SCORING, PENALTY_SCORING,
QUESTION_FORMAT, TOLERANCE — mark exactly one option.

### Empty fields
Leave the content area blank (nothing between header and next header):
```
%------PARAMETERS------%
%------CONSTRAINTS------%
```
Empty sections are fine — the parser ignores them.

### Multi-value fields
Use the `&&&` triple-and operator to separate multiple values **on the same line** or across lines.
The EDU format accepts both inline and multi-line — keep it readable:
```
%------ANSWER------%
Option A &&& Option B &&& Option C
```

### No trailing whitespace issues
The parser is whitespace-tolerant but keep values clean.

---

## Complete Section Order

Always output sections in this exact order (matches the template):

```
LANGUAGE
QUESTION!!
ANSWER!!
TYPE!!
SUBJECT!
CATEGORY!
MAIN_CATEGORY
PARAMETERS
CONSTRAINTS
POINTS
SUBSCORING
SUBPOINTS
MANUAL_SCORING
PENALTY_POINTS
PENALTY_SCORING
OPTIONS
NOTE
PRIVATE_NOTE
EXPLANATION
SOLUTION
SOLUTION_IMAGE
HINT
VIDEO
DIFFICULTY
ANSWER_REQUIRE
QUESTION_FORMAT
ANSWER_FORMAT
SOURCE
TAG
DECIMALS
MAXIMUM_CHOICES
OPTIONS_FIX
ANSWER_ORDER
ANSWER_HIDE
ANSWER_LABEL
ANSWER_INDEFINITE
GROUP
EXPRESSION_CHECK
EXPRESSION_DECIMALS
EXPRESSION_RANDOM_TYPE
EXPRESSION_RANDOM_TRIES
EXPRESSION_RANDOM_RANGE
EXPRESSION_RANDOM_INSIDE
EXPRESSION_RANDOM_OUTSIDE
EXPRESSION_EXPLICIT_GOAL
EXPRESSION_EXTENDED
EXPRESSION_FUNCTIONS
EXPRESSION_VARIABLE
IMAGE
ATTACHMENT
MEDIA_VIDEO
MEDIA_AUDIO
OPTIONS_ORDER
NUMERICAL_RANGE
FREETEXT_CHARACTERS
FREETEXT_WORDS
FREETEXT_RULES
TRUEFALSE_THIRD_OPTIONS
TRUEFALSE_THIRD_OPTIONS_LABEL
DATETIME_PRECISION
DATETIME_RANGE
GROUPING
PARAMETERS_SYNC
TOLERANCE
GRAPH
SOLUTION_PENALTY
HINT_PENALTY
VIDEO_PENALTY
FILE_COUNT
FILE_TYPES
HOTSPOT_IMAGE
HOTSPOT_ZONES
TAGS
EXTERNAL_ID
```

---

## EDU-Specific Field Name Differences ⚠️

The EDU format uses slightly different names than the XLSX column names in a few cases:

| XLSX column name | EDU section name | Note |
|-----------------|-----------------|------|
| `NUMERIC` | `NUMERICAL` | TYPE checkbox says `NUMERICAL` |
| `NUMERICAL_RANGE` | `NUMERICAL_RANGE` | Same |
| `TAGS` | `TAGS` | End of file (org/user tags by ID) |
| `TAG` | `TAG` | Earlier in file (legacy label field) |
| `EXPRESSION_RANDOM_GOAL` | `EXPRESSION_EXPLICIT_GOAL` | Different name in EDU! |

Always use the EDU section names listed in the Complete Section Order above.

---

## Checkbox Sections — Full Option Lists

### TYPE (mark exactly one)
```
%------TYPE!!------%
% [ ] CHOICE
% [ ] MULTIPLE-CHOICE
% [ ] TRUE/FALSE
% [ ] NUMERICAL
% [ ] EXPRESSION
% [ ] ORDER
% [ ] GROUPING
% [ ] PAIRING
% [ ] MATRIX
% [ ] MATRIX:EXPRESSION
% [ ] SET
% [ ] SET:TEXT
% [ ] DATE/TIME
% [ ] TEXT
% [ ] FREE-TEXT
% [ ] FILE
% [ ] HOTSPOT
% [ ] READING
% [ ] GENERIC
```

### SUBSCORING (default: PROPORTIONAL)
```
%------SUBSCORING------%
% [X] PROPORTIONAL
% [ ] LINEAR_SUBSTRACTED:N
% [ ] CUSTOM
% [ ] NONE
```
Note: `LINEAR_SUBSTRACTED` (with D) — this is the spelling in the EDU format.

### MANUAL_SCORING (default: NO)
```
%------MANUAL_SCORING------%
% [X] NO
% [ ] NOT_CORRECT
% [ ] ALWAYS
```

### PENALTY_SCORING (default: DEFAULT)
```
%------PENALTY_SCORING------%
% [X] DEFAULT
% [ ] PER_ANSWER
% [ ] PER_QUESTION
```

### QUESTION_FORMAT (default in template: LATEX)
```
%------QUESTION_FORMAT------%
% [ ] NORMAL
% [X] LATEX
% [ ] LONG
```
⚠️ The template defaults to LATEX — change to NORMAL if the question has no math.

### TOLERANCE (mark one, or leave all unchecked if not applicable)
```
%------TOLERANCE------%
% [ ] ABSOLUTE:N
% [ ] RELATIVE:N
% [ ] QUOTIENT
% [ ] QUOTIENT2
% [ ] QUOTIENT:SYNCED
% [ ] QUOTIENT2:SYNCED
```

---

## Output Approach

### When writing a single EDU file:
1. Output the complete EDU content in a code block (for preview)
2. Write it to a `.edu` file and present it for download
3. Include ALL 74 sections — even empty ones — to match the template exactly

### When writing multiple questions:
- Each question = one separate `.edu` file
- Name files descriptively: `question-type-topic.edu` or `q01.edu`, `q02.edu`, etc.
- Package into a ZIP if more than 3 files

### Minimal viable EDU (just mandatory + recommended fields filled):
Fill `QUESTION!!`, `ANSWER!!`, `TYPE!!`, `SUBJECT!`, `CATEGORY!` — leave everything else blank.
Still include all section headers.

---

## Full Template

The complete blank template is in `assets/template.edu`.
Load it with `view /path/to/skill/assets/template.edu` when you need the exact blank structure.

When generating output, reproduce the full template structure, substituting values into the
appropriate sections. Do not omit any section headers, even if the content is empty.

---

## Example — CHOICE question

```
%------LANGUAGE------%
hu
%------QUESTION!!------%
Mi a főváros neve?
%------ANSWER!!------%
Budapest
%------TYPE!!------%
% [ ] CHOICE
% [X] ...
```

→ See `references/examples.md` for complete worked examples for each major question type.

---

## Workflow with edubase-question-creator

1. Use **edubase-question-creator** to decide: type, answer syntax, operators, parameters
2. Use **this skill** to serialize the result into valid EDU file format
3. When in doubt about field semantics → edubase-question-creator
4. When in doubt about EDU syntax/structure → this skill

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [EduBase](https://github.com/EduBase)
- **Source:** [EduBase/skills](https://github.com/EduBase/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-edubase-skills-edubase-edu-writer
- Seller: https://agentstack.voostack.com/s/edubase
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.