# Tutorial

Interactive walkthrough for new users.

- Repository: https://github.com/agenticnotetaking/arscontexta (3518 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-02-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agenticnotetaking/arscontexta --skill tutorial -g -a claude-code -y`
Codex: `npx skills add agenticnotetaking/arscontexta --skill tutorial -g -a codex -y`
Cursor: `npx skills add agenticnotetaking/arscontexta --skill tutorial -g -a cursor -y`
Gemini CLI: `npx skills add agenticnotetaking/arscontexta --skill tutorial -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add agenticnotetaking/arscontexta`

## Description

Interactive walkthrough for new users. Learn by doing, each step creates real content in your vault. Three tracks (researcher, manager, personal) with a universal learning arc. Triggers on "/tutorial", "walk me through", "how do I use this".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Runtime Configuration (Step 0, before any processing)

Read these files to configure domain-specific behavior:

1. **`ops/derivation-manifest.md`**, vocabulary mapping, platform hints
   - Use `vocabulary.notes` for the notes folder name
   - Use `vocabulary.note` / `vocabulary.note_plural` for note type references
   - Use `vocabulary.reduce` for the extraction verb
   - Use `vocabulary.reflect` for the connection-finding verb
   - Use `vocabulary.topic_map` for MOC references
   - Use `vocabulary.inbox` for the inbox folder name

2. **`ops/config.yaml`**, processing depth, domain context

If these files don't exist, use universal defaults.

## EXECUTE NOW

**Target: $ARGUMENTS**

- If `ops/tutorial-state.yaml` exists and `current_step` <= 5: resume from saved step
- If target is "reset": delete `ops/tutorial-state.yaml` and start fresh
- If no state file exists: begin new tutorial with track selection

**START NOW.** Reference below defines the flow.

---

## Resume Detection

Read `ops/tutorial-state.yaml`. If it exists and tutorial is incomplete, display:
```
--=={ ars contexta : tutorial }==--

  Welcome back.
  Track: [track]     [step-progress] Step [N] of 5
  Resuming where you left off...
```

Skip to the saved `current_step`. Do NOT re-ask for track. If `current_step` > 5, tutorial is complete, offer to reset.

**Progress indicator format:**
- Step 1 of 5: `[=>    ]`
- Step 2 of 5: `[==>   ]`
- Step 3 of 5: `[===>  ]`
- Step 4 of 5: `[====> ]`
- Step 5 of 5: `[=====>]`

## Track Selection (new tutorial only)

Display header, then use AskUserQuestion:

```
--=={ ars contexta : tutorial }==--

Which track fits your work best?

  (a) Researcher -- academic papers, domain
      research, literature processing

  (b) Manager -- meeting notes, strategy docs,
      decision tracking

  (c) Personal -- daily observations, goal
      setting, reflective journaling
```

Wait for response. Map a/b/c to researcher/manager/personal.

The rest: https://github.com/agenticnotetaking/arscontexta/blob/HEAD/skills/tutorial/SKILL.md