Agent skill

archetype-import

Imports Shadowrun 5e character archetypes from sourcebook stat blocks into hierarchical markdown and PDF documents with priority inference and data validation. Use when converting official SR5 archetypes to Shadow Master format.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/archetype-import

SKILL.md

Archetype Import Skill

This skill guides the import of official Shadowrun 5e character archetypes from sourcebook stat block images into structured markdown documents suitable for Shadow Master testing and development.

Purpose

Convert published SR5 archetype stat blocks into:

  1. Hierarchical markdown documents with proper equipment relationships
  2. Priority inference calculations with confidence scores
  3. Database validation reports against core-rulebook.json
  4. PDF versions for easy sharing and printing

Critical Rules

Training Data Exclusion

IMPORTANT: When using existing example character files as reference:

  • EXCLUDE any files matching *-v*.md pattern (e.g., example-character-street-samurai-v2.md)
  • These versioned files are works-in-progress or experimental formats
  • Only use base files like example-character-street-samurai-ork.md as training data

Output Location

All archetype imports produce two files:

docs/data_tables/creation/example-character-{archetype-slug}-v{version}.md
docs/data_tables/creation/example-character-{archetype-slug}-v{version}.pdf

Where:

  • {archetype-slug} = kebab-case archetype name (e.g., street-samurai, combat-mage)
  • {version} = iteration number (start at 1, increment for revisions)

The PDF is generated automatically from the markdown using md-to-pdf.

Gameplay Level Identification

Before beginning validation, identify the gameplay level based on resource allocation and restrictions.

Level Starting Karma Resources (A/B/C/D/E) Availability Device Rating
Street 13 75K/50K/25K/15K/6K ≤10 ≤4
Standard 25 450K/275K/140K/50K/6K ≤12 ≤6
Prime Runner 35 500K/325K/210K/150K/100K ≤15 —

Identification Heuristics:

  1. Check resource totals - If total gear exceeds 450K, likely Prime Runner
  2. Check availability - If any item >12 availability, likely Prime Runner
  3. Check starting karma - If negative qualities suggest >25 starting karma budget, likely Prime Runner
  4. Check device ratings - If commlinks/decks >Rating 6, likely Prime Runner

Output Format:

markdown
### Gameplay Level Identification

**Detected Level:** Standard
**Evidence:**

- Total resources: 249,500¥ (within 275K Budget B)
- Max availability: 12R (Wired Reflexes 2)
- Max device rating: 5 (Hermes Ikon)
- Estimated karma budget: 25 (standard)

Input Requirements

When importing an archetype, gather:

  1. Archetype name (e.g., "Street Samurai", "Combat Mage")
  2. Metatype (Human, Elf, Dwarf, Ork, Troll)
  3. Source (book name and page number)
  4. Stats block image (screenshot or scan of the archetype page)

Hierarchical Structure Rules

Equipment in Shadowrun has parent-child relationships. The markdown output must reflect these hierarchies using sub-tables or bullet lists under the parent item.

Pattern 1: Weapons with Modifications and Ammunition

Good Example (Hierarchical):

markdown
## Weapons

### Ranged Weapons

| Weapon          | Type         | Accuracy | DV  | AP  | Mode | RC  | Ammo  | Cost |
| --------------- | ------------ | -------- | --- | --- | ---- | --- | ----- | ---- |
| Ares Predator V | Heavy Pistol | 5(7)     | 8P  | -1  | SA   | -   | 15(c) | 725¥ |

**Ares Predator V Modifications:**

- **Internal:** Smartgun System (Internal) [+2 Accuracy, 200¥]
- **Barrel:** Suppressor [Sound suppression, 500¥]

**Ares Predator V Ammunition:**

- Regular Ammo ×100 (10¥ per 10)
- APDS ×50 (-4 AP, 120¥ per 10)

| HK-227 | SMG | 5(7) | 7P | - | SA/BF/FA | 1 | 28(c) | 730¥ |

**HK-227 Modifications:**

- **Top:** Imaging Scope [Vision magnification, 300¥]
- **Under:** Gas-Vent 2 System [+2 RC, 400¥]
- **Stock:** Folding Stock [Concealability -2, 50¥]

**HK-227 Ammunition:**

- Explosive Rounds ×100 (-1 AP, +1 DV, 80¥ per 10)

Bad Example (Flat):

markdown
| Item              | Cost |
| ----------------- | ---- |
| Ares Predator V   | 725¥ |
| Smartgun System   | 200¥ |
| Suppressor        | 500¥ |
| Regular Ammo ×100 | 10¥  |

Pattern 2: Cyberware with Enhancements (Especially Cyberlimbs)

Cyberlimbs are capacity containers. Enhancements install INTO them.

Good Example (Hierarchical):

markdown
## Augmentations

### Cyberware

| Augmentation              | Grade    | Essence | Capacity | Cost    |
| ------------------------- | -------- | ------- | -------- | ------- |
| Cyberarm (Right, Obvious) | Standard | 1.0     | 15       | 15,000¥ |

**Right Cyberarm Enhancements (10/15 capacity used):**

- Strength Enhancement +3 [3 capacity, 9,000¥]
- Agility Enhancement +3 [3 capacity, 9,000¥]
- Armor Enhancement +2 [2 capacity, 4,000¥]
- Cybergun (SMG, Ingram Smartgun X) [built-in, no capacity, 3,000¥]
- Slide Mount [2 capacity, 3,000¥]

**Right Cyberarm Totals:**

- STR: 6 base + 3 enhanced = 9
- AGI: 6 base + 3 enhanced = 9
- Armor: +2

| Cyberarm (Left, Obvious) | Standard | 1.0 | 15 | 15,000¥ |

**Left Cyberarm Enhancements (8/15 capacity used):**

- Strength Enhancement +3 [3 capacity, 9,000¥]
- Agility Enhancement +2 [2 capacity, 6,000¥]
- Cyber Spur [3 capacity, 7,000¥]

Bad Example (Missing hierarchy):

markdown
| Augmentation            | Grade    | Essence | Cost    |
| ----------------------- | -------- | ------- | ------- |
| Cyberarm (Right)        | Standard | 1.0     | 15,000¥ |
| Strength Enhancement +3 | -        | -       | 9,000¥  |
| Agility Enhancement +3  | -        | -       | 9,000¥  |

Pattern 3: Armor with Modifications

Armor has capacity equal to its armor rating. Mods consume capacity.

Good Example:

markdown
### Armor

| Armor      | Rating | Capacity | Cost |
| ---------- | ------ | -------- | ---- |
| Lined Coat | 9      | 9        | 900¥ |

**Lined Coat Modifications (9/9 capacity used):**

- Chemical Protection 3 [3 capacity, 750¥]
- Fire Resistance 3 [3 capacity, 750¥]
- Nonconductivity 3 [3 capacity, 750¥]

| Armor Jacket | 12 | 12 | 1,000¥ |

**Armor Jacket Modifications (6/12 capacity used):**

- Insulation 3 [3 capacity, 600¥]
- Thermal Damping 3 [3 capacity, 1,500¥]

Pattern 4: Fake SINs with Attached Licenses

Licenses attach TO a specific SIN at the same rating.

Good Example:

markdown
### Identities

| Identity     | SIN Type | Rating | Cost    |
| ------------ | -------- | ------ | ------- |
| "John Smith" | Fake SIN | 4      | 10,000¥ |

**"John Smith" Licenses (Rating 4):**

- Concealed Carry Permit [200¥]
- Firearms License [200¥]
- Augmentation License [200¥]
- Driver's License [200¥]

| "Jane Doe" | Fake SIN | 2 | 5,000¥ |

**"Jane Doe" Licenses (Rating 2):**

- Driver's License [200¥]

Pattern 5: Drones/Vehicles with Autosofts and Mounted Weapons

Good Example:

markdown
### Drones

| Drone                 | Hand | Speed | Accel | Body | Armor | Pilot | Sensor | Cost   |
| --------------------- | ---- | ----- | ----- | ---- | ----- | ----- | ------ | ------ |
| MCT-Nissan Roto-Drone | 4    | 4     | 2     | 4    | 4     | 3     | 3      | 5,000¥ |

**Roto-Drone Loadout:**

- **Mounted Weapon:** AK-97 (Assault Rifle, removed stock)
- **Weapon Ammunition:** Regular Ammo ×200

**Roto-Drone Autosofts:**

- Clearsight 3 [600¥]
- Evasion 3 [600¥]
- Maneuvering (Roto-Drone) 3 [600¥]
- Targeting (Assault Rifle) 3 [600¥]

| Lockheed Optic-X2 | 4 | 4 | 3 | 1 | 0 | 3 | 3 | 21,000¥ |

**Optic-X2 Autosofts:**

- Clearsight 4 [800¥]
- Stealth 4 [800¥]

Pattern 6: Cybereyes/Cyberears with Enhancements

Good Example:

markdown
| Cybereyes (Rating 3) | Standard | 0.4 | 12 capacity | 10,000¥ |

**Cybereyes Enhancements (10/12 capacity used):**

- Flare Compensation [1 capacity, 250¥]
- Low-Light Vision [2 capacity, 500¥]
- Smartlink [3 capacity, 2,000¥]
- Thermographic Vision [2 capacity, 500¥]
- Vision Enhancement 2 [2 capacity, 1,000¥]

| Cyberears (Rating 2) | Standard | 0.3 | 8 capacity | 6,000¥ |

**Cyberears Enhancements (6/8 capacity used):**

- Audio Enhancement 2 [2 capacity, 500¥]
- Spatial Recognizer [2 capacity, 1,000¥]
- Select Sound Filter 2 [2 capacity, 500¥]

Pattern 7: Commlinks with Running Programs

Good Example:

markdown
### Matrix Gear

| Device               | Rating | Cost   |
| -------------------- | ------ | ------ |
| Hermes Ikon Commlink | 5      | 3,000¥ |

**Hermes Ikon Software:**

- AR Gloves [150¥]
- Mapsoft (Seattle) [20¥]
- Sim Module (Hot) [included]

Priority Inference Methodology

Step 1: Calculate Attribute Points Spent

For each attribute, calculate points purchased:

Points = (Current Value) - (Metatype Base)

Metatype Base Attributes:

Metatype BOD AGI REA STR WIL LOG INT CHA
Human 1 1 1 1 1 1 1 1
Elf 1 2 1 1 1 1 1 3
Dwarf 3 1 1 3 2 1 1 1
Ork 4 1 1 3 1 1 1 1
Troll 5 1 1 5 1 1 1 1

Example Calculation (Ork Street Samurai):

Body 7:      7 - 4 (Ork base) = 3 points
Agility 6:   6 - 1 (Ork base) = 5 points
Reaction 5:  5 - 1 (Ork base) = 4 points
Strength 5:  5 - 3 (Ork base) = 2 points
Willpower 3: 3 - 1 (Ork base) = 2 points
Logic 2:     2 - 1 (Ork base) = 1 point
Intuition 3: 3 - 1 (Ork base) = 2 points
Charisma 2:  2 - 1 (Ork base) = 1 point
─────────────────────────────────────────
Total: 20 points → Priority B (20 points)

Step 2: Calculate Skill Points/Groups

Count total skill points and skill group ratings:

  • Sum all active skill ratings = skill points
  • Sum all skill group ratings = group points

Match against priority table:

Priority Skills Groups
A 46 10
B 36 5
C 28 2
D 22 0
E 18 0

Step 3: Calculate Resources Spent

Sum all costs including:

  • Weapons (base + mods + ammo)
  • Armor (base + mods)
  • Cyberware (with grade multipliers)
  • Bioware (with grade multipliers)
  • Gear
  • Vehicles/Drones
  • Lifestyle prepaid months
  • Foci
  • Commlinks/Cyberdecks

Match against priority table:

Priority Resources
A 450,000¥
B 275,000¥
C 140,000¥
D 50,000¥
E 6,000¥

Step 4: Determine Magic/Resonance Priority

Based on magical path and attributes:

  • Priority A: Magic 6 + spells/complex forms
  • Priority B: Magic 4-5 or Adept Magic 6
  • Priority C: Magic 3-4
  • Priority D: Magic 2 (Adept/Aspected only)
  • Priority E: Mundane

Step 5: Determine Metatype Priority

Cross-reference metatype with special attribute points:

Priority Human Elf Dwarf Ork Troll
A 9 8 7 7 5
B 7 6 4 4 0
C 5 3 1 0 -
D 3 0 - - -
E 1 - - - -

Calculate special attribute points spent on Edge.

Karma Expenditure Validation

After priority inference, validate how the starting karma was spent.

Karma Budget by Gameplay Level

Level Starting Karma Max Karma-to-Nuyen
Street 13 5 (→10,000¥)
Standard 25 10 (→20,000¥)
Prime Runner 35 25 (→50,000¥)

Karma Expenditure Categories

Category Cost Limit
Positive Qualities Listed cost ≤25 Karma total
Negative Qualities Receive listed ≤25 Karma bonus
Karma-to-Nuyen 1:2,000¥ Level-dependent (see above)
Active Skill New Rating × 2 Max rating 6 (7 with Aptitude)
Skill Group New Rating × 5 Max rating 6
Specialization 7 Karma One per skill
Attribute New Rating × 5 One Physical OR Mental at max
Spells/Rituals/Preparations 5 Karma each ≤Magic × 2 each category
Complex Forms 4 Karma each ≤Logic
Focus Bonding Force × multiplier Count ≤ Magic, Total Force ≤ Magic×2
Power Points (Mystic Adept) 5 Karma each ≤Magic rating
Contact Connection+Loyalty 2-7 Karma per contact, min 1+1

Skill Karma Cost Reference

From → To Karma Cost Cumulative (from 0)
0 → 1 2 2
1 → 2 4 6
2 → 3 6 12
3 → 4 8 20
4 → 5 10 30
5 → 6 12 42

Karma-Optimal Skill Allocation

CRITICAL: When a character has more total skill points than their priority provides, the order of allocation matters significantly for karma efficiency.

The Problem: If you allocate priority points to low-rated skills first, you'll be forced to buy high-rated skills with karma, which is extremely expensive.

Example - Face (Elf) with Priority A Skills:

  • Priority A provides: 46 skill points + 10 group points
  • Character needs: 48 skill points (2 over budget)
  • Skills include: Etiquette 5, Negotiation 5, various 4s, and First Aid 1, Pilot Ground 1

Wrong approach (expensive):

  • Allocate 46 points including First Aid 1 and Pilot Ground 1
  • Buy remaining skills (e.g., Unarmed 2) with karma
  • Cost: Unarmed 0→2 = 6 karma

Correct approach (cheap):

  • Allocate 46 points to HIGH-value skills first (5s, 4s, then 2s)
  • Buy the CHEAPEST skills (rating 1s) with karma
  • Cost: First Aid 0→1 (2 karma) + Pilot Ground 0→1 (2 karma) = 4 karma

Savings: 2 karma (which can mean the difference between legal and illegal)

Skill Allocation Order of Operations

When building a character with excess skill points:

  1. Calculate total skill points needed (sum of all individual skill ratings)
  2. Calculate priority skill points available (from priority table)
  3. Calculate excess (needed - available)
  4. Sort skills by rating (highest to lowest)
  5. Allocate priority points from highest-rated skills down
  6. Leave the lowest-rated skills (rating 1s) to buy with karma
  7. Verify karma cost for the leftover skills

Allocation Priority Order:

  1. Rating 6 skills (12 karma each to buy)
  2. Rating 5 skills (10 karma each to buy)
  3. Rating 4 skills (8 karma each to buy)
  4. Rating 3 skills (6 karma each to buy)
  5. Rating 2 skills (4 karma each to buy)
  6. Rating 1 skills (2 karma each to buy) ← Buy these with karma

Shadow Master Implementation Notes

When entering skills in Shadow Master:

  1. First: Enter all skill groups (these use group points, not skill points)
  2. Second: Enter high-rated individual skills (5s and 4s) using priority points
  3. Third: Enter medium-rated skills (3s and 2s) using remaining priority points
  4. Last: Enter rating-1 skills - these should consume karma, not priority points

If you run out of karma before completing all skills, go back and reallocate:

  • Remove points from a rating-1 skill (freeing priority points)
  • Add those points to a higher-rated skill that was using karma
  • The rating-1 skill now uses karma (cheaper) instead of the higher-rated skill

Focus Bonding Costs

Focus Type Multiplier F1 F2 F3 F4 F5 F6
Qi Focus ×2 2 4 6 8 10 12
Spell Focus ×2 2 4 6 8 10 12
Spirit Focus ×2 2 4 6 8 10 12
Enchanting Focus ×3 3 6 9 12 15 18
Metamagic Focus ×3 3 6 9 12 15 18
Weapon Focus ×3 3 6 9 12 15 18
Power Focus ×6 6 12 18 24 30 36

Output Format

markdown
### Karma Expenditure Validation

**Starting Karma:** 25 (Standard level)

| Category           | Items                           | Cost | Running Total  |
| ------------------ | ------------------------------- | ---- | -------------- |
| Positive Qualities | Ambidextrous (4), Toughness (9) | 13   | 13             |
| Negative Qualities | SINner (Corporate) (-25)        | -25  | -12            |
| Karma-to-Nuyen     | 5 Karma → 10,000¥               | 5    | -7             |
| Contact Pool       | Fixer (3/2), Street Doc (2/1)   | 8    | 1              |
| Focus Bonding      | Weapon Focus F3                 | 9    | 10             |
| Skills             | Pistols 1→2 (4), Sneak spec (7) | 11   | 21             |
| **Total Spent**    |                                 | 46   |                |
| **Net Karma**      | 25 - 46 + 25 (negatives)        | 4    | ✓ ≤7 carryover |

**Validation:**

- ✓ Positive qualities (13) ≤ 25 limit
- ✓ Negative qualities (25) ≤ 25 limit
- ✓ Karma-to-Nuyen (5) ≤ 10 limit (Standard)
- ✓ Remaining karma (4) ≤ 7 carryover limit

Knowledge & Language Skill Validation

Formula

Free Knowledge Points = (Intuition + Logic) × 2

Example Calculation

Intuition Logic Free Points
3 2 10
4 3 14
5 4 18

Knowledge Skill Categories

Category Linked Attribute
Academic Logic
Professional Logic
Interests Intuition
Street Intuition

Output Format

markdown
### Knowledge & Language Skills

**Free Points:** (INT 4 + LOG 3) × 2 = **14 points**

| Skill                         | Category     | Rating | Points |
| ----------------------------- | ------------ | ------ | ------ |
| English                       | Language     | N      | 0      |
| Spanish                       | Language     | 3      | 3      |
| Seattle Street Gangs          | Street       | 4      | 4      |
| Corporate Security Procedures | Professional | 3      | 3      |
| Firearms Manufacturers        | Interests    | 2      | 2      |
| **Total**                     |              |        | **12** |

**Validation:** ✓ 12 points spent ≤ 14 available

Contact Pool Validation

Formula

Free Contact Karma = Charisma × 3

Note: This pool can ONLY be used for contacts, not other karma expenditures.

Limits

  • Per Contact: 2-7 Karma (min 1 Connection + 1 Loyalty)
  • No limit on number of contacts

Contact Cost Matrix

Connection Loy 1 Loy 2 Loy 3 Loy 4 Loy 5 Loy 6
1 2 3 4 5 6 7
2 3 4 5 6 7 —
3 4 5 6 7 — —
4 5 6 7 — — —
5 6 7 — — — —
6 7 — — — — —

Output Format

markdown
### Contact Pool Validation

**Free Contact Karma:** CHA 3 × 3 = **9 Karma**

| Contact             | Connection | Loyalty | Cost  |
| ------------------- | ---------- | ------- | ----- |
| Fixer (Mr. Johnson) | 3          | 2       | 5     |
| Street Doc (Patch)  | 2          | 1       | 3     |
| **Total**           |            |         | **8** |

**Validation:** ✓ 8 Karma spent ≤ 9 available
**Excess to General Pool:** 1 Karma (can be used for other purchases)

Magic Purchase Limits (Awakened Characters)

Spells, Rituals, and Preparations

Category Karma Cost Creation Limit
Spells 5 each ≤ Magic × 2
Rituals 5 each ≤ Magic × 2
Preparations 5 each ≤ Magic × 2

Example: Magic 4 character can have up to 8 spells, 8 rituals, and 8 preparations.

Focus Bonding Limits at Creation

Limit Formula
Max bonded count ≤ Magic
Max total Force ≤ Magic×2
Force per test Only 1

Example: Magic 4 can bond up to 4 foci with total Force ≤ 8.

Mystic Adept Power Points

  • Cost: 5 Karma per Power Point
  • Limit: Cannot exceed Magic rating
  • Note: Adepts get Power Points free (= Magic rating)

Output Format

markdown
### Magic Validation

**Magic Rating:** 4 (Magician)
**Tradition:** Hermetic

**Spells (6/8 limit):**

- Stunbolt, Manabolt, Armor, Heal, Improved Invisibility, Levitate

**Foci (2 foci, Force 5/8 limit):**
| Focus | Force | Bonding Cost |
| -------------- | ----- | ------------ |
| Spell Focus | 3 | 6 Karma |
| Power Focus | 2 | 12 Karma |
| **Total** | 5 | **18 Karma** |

**Validation:**

- ✓ Spells (6) ≤ Magic×2 (8)
- ✓ Foci count (2) ≤ Magic (4)
- ✓ Total Force (5) ≤ Magic×2 (8)

Creation Limits Summary

Hard Limits (All Levels)

Category Limit
Karma carryover ≤7
Nuyen carryover ≤5,000¥
Positive qualities ≤25 Karma
Negative qualities ≤25 Karma bonus
Attribute augmentation +4 max per attribute
Physical at max Only 1
Mental at max Only 1
Skill rating ≤6 (7 with Aptitude)
Bonded foci count ≤Magic
Bonded foci Force ≤Magic × 2
Spells per category ≤Magic × 2
Complex forms ≤Logic
Bound spirits ≤Charisma
Registered sprites ≤Charisma

Level-Dependent Limits

Limit Street Standard Prime
Starting Karma 13 25 35
Availability ≤10 ≤12 ≤15
Device Rating ≤4 ≤6 —
Karma-to-Nuyen 5 10 25

Output Format

markdown
### Creation Limits Validation

| Limit                 | Value | Max   | Status |
| --------------------- | ----- | ----- | ------ |
| Karma carryover       | 4     | 7     | ✓      |
| Nuyen carryover       | 2,500 | 5,000 | ✓      |
| Positive qualities    | 13    | 25    | ✓      |
| Negative qualities    | 25    | 25    | ✓      |
| Physical at max       | 1     | 1     | ✓      |
| Mental at max         | 0     | 1     | ✓      |
| Max skill rating      | 6     | 6     | ✓      |
| Max availability      | 12R   | 12    | ✓      |
| Max device rating     | 5     | 6     | ✓      |
| Foci count            | 2     | 4     | ✓      |
| Foci total Force      | 5     | 8     | ✓      |
| Spells (per category) | 6     | 8     | ✓      |

Output Format

markdown
## Priority Inference

### Attribute Points Calculation

- Body 7 (Ork base 4 + 3 purchased) = 3 points
- Agility 6 (base 1 + 5 purchased) = 5 points
- Reaction 5 (base 1 + 4 purchased) = 4 points
- Strength 5 (base 3 + 2 purchased) = 2 points
- Willpower 3 (base 1 + 2 purchased) = 2 points
- Logic 2 (base 1 + 1 purchased) = 1 point
- Intuition 3 (base 1 + 2 purchased) = 2 points
- Charisma 2 (base 1 + 1 purchased) = 1 point
- **Total: 20 points** → Priority B (20 points)

### Skills Calculation

- Automatics 5 + Blades 5 + Longarms 3 + Pilot Ground 1 + Pistols 4 + Sneaking 2 + Unarmed 2 = 22 points
- Skill Groups: 0
- **Total: 22/0** → Priority D

### Resources Calculation

| Category   | Subtotal     |
| ---------- | ------------ |
| Cyberware  | 195,000¥     |
| Weapons    | 8,500¥       |
| Ammunition | 2,000¥       |
| Armor      | 5,000¥       |
| Gear       | 12,000¥      |
| Lifestyle  | 15,000¥      |
| Vehicles   | 12,000¥      |
| **Total**  | **249,500¥** |

→ Priority B (275,000¥) with karma-to-nuyen conversion possible

### Metatype Calculation

- Metatype: Ork
- Edge: 1
- Special attribute points available at Priority C (Ork): 0
- **Matches Priority C**

### Magic Calculation

- Magical Path: Mundane
- **Priority E** (no magic required)

### Priority Summary

| Priority | Category   | Confidence | Notes                     |
| -------- | ---------- | ---------- | ------------------------- |
| A        | Resources  | 95%        | 249K close to 275K budget |
| B        | Attributes | 100%       | 20 points exact match     |
| C        | Metatype   | 100%       | Ork with 0 special        |
| D        | Skills     | 90%        | 22/0 matches D            |
| E        | Magic      | 100%       | Mundane                   |

Validation Requirements

Pre-Generation Validation

Before generating the markdown:

  1. Check item existence - Verify all items exist in /data/editions/sr5/core-rulebook.json
  2. Check naming consistency - Match exact names from catalog (see Fuzzy Matching below)
  3. Check availability limits - Items must be ≤12 availability at creation (without qualities)

Default Rating Rule

CRITICAL: When a stat block lists an item that has ratings in the database but does NOT specify a rating, default to Rating 1.

Example:

  • Stat block shows: "Bug Scanner — 100¥"
  • Database has: Bug Scanner (Rating 1-6, costs 100¥-600¥)
  • Correct interpretation: Bug Scanner Rating 1 at 100¥

Common rated items that often omit ratings:

Item Rating Range R1 Cost R6 Cost
Bug Scanner 1-6 100¥ 600¥
White Noise Generator 1-6 50¥ 300¥
Jammer (Area) 1-6 200¥ —
Medkit 1-6 250¥ 1,500¥
Fake SIN 1-6 2,500¥ 15,000¥
Autopicker 1-6 50¥ 300¥

Validation: If the stat block price doesn't match Rating 1, check if it matches another rating and document accordingly.

Fuzzy Matching for Item Names

CRITICAL: Sourcebook stat blocks often use slightly different names than the database. Before marking an item as "missing," perform fuzzy matching to find close matches.

Name Normalization Steps

When an exact match fails, normalize both the stat block name and database names:

  1. Remove/normalize hyphens and spaces:

    • Ultra Power → ultrapower
    • Ultra-Power → ultrapower
    • Match: ✓

  2. Normalize Roman numerals vs digits:

    • Predator V → predator5
    • Predator 5 → predator5
    • Match: ✓

  3. Handle parenthetical variations:

    • Smartgun System (Internal) → smartgunsysteminternal
    • Internal Smartgun System → search for "smartgun" + "internal"

  4. Case-insensitive comparison:

    • APDS = apds = Apds

  5. Handle common abbreviations:

    • E-War ↔ Electronic Warfare
    • AR ↔ Assault Rifle
    • SMG ↔ Submachine Gun

Fuzzy Search Algorithm

1. Exact match → Use database name
2. Normalized match (remove hyphens/spaces, lowercase) → Use database name
3. Substring match (stat block name contained in database name) → Flag as "close match"
4. Token overlap (≥80% of words match) → Flag as "close match"
5. No match → Mark as "missing"

Common Name Variations

Stat Block Name Database Name Variation Type
Browning Ultra Power Browning Ultra-Power Hyphen
Ares Predator 5 Ares Predator V Roman numeral
Ingram Smartgun X Ingram Smartgun XI Numeral typo
Fichetti Sec 600 Fichetti Security 600 Abbreviation
Earbuds Ear Buds Word split
Hardware kit Hardware Toolkit Synonym
Jammer (area) Area Jammer Word order
Silencer Silencer/Suppressor Partial name
Concealed holster Concealable Holster Adjective form
Regular ammunition Regular Rounds Synonym
Wired Reflexes 2 Wired Reflexes Rating in name

Updated Validation Output Format

markdown
### Matched Items (45/50)

**Exact matches:** 42 items found in `/data/editions/sr5/core-rulebook.json`

**Close matches (auto-corrected):**
| Stat Block Name | Database Name | Correction Applied |
| -------------------- | -------------------- | ------------------ |
| Browning Ultra Power | Browning Ultra-Power | Added hyphen |
| Earbuds | Ear Buds | Split words |
| Silencer | Silencer/Suppressor | Full name |

### Missing from Database (3 items)

| Item                     | Type     | Fuzzy Search Results               |
| ------------------------ | -------- | ---------------------------------- |
| Electrochromatic T-shirt | Clothing | No close matches found             |
| Custom Grip Mod          | Weapon   | Partial: "Grip" in 3 items         |
| Ares Roto-Drone MkII     | Drone    | Close: "Ares Roto-Drone" (no MkII) |

Implementation: grep Commands for Fuzzy Search

When validating items, use these grep patterns:

bash
# Exact match
grep -i '"name": "Browning Ultra Power"' /data/editions/sr5/core-rulebook.json

# Normalized search (ignore hyphens/spaces)
grep -i '"name":.*browning.*ultra.*power' /data/editions/sr5/core-rulebook.json

# Partial/substring search
grep -i '"name":.*browning' /data/editions/sr5/core-rulebook.json | head -20

# Find all weapons to manually review
grep -i '"name":' /data/editions/sr5/core-rulebook.json | grep -i pistol

Calculation Validation

  1. Essence tracking - Sum all cyberware/bioware essence costs, verify matches stated essence
  2. Capacity tracking - Verify enhancements don't exceed container capacity
  3. Cost verification - Verify category subtotals and grand total
  4. Grade multipliers - Verify cyberware costs include grade multipliers

Hierarchy Validation

  1. Parent-child relationships - Every enhancement must have a parent
  2. Capacity bounds - No container can exceed its rated capacity
  3. License-SIN binding - Licenses must match their parent SIN rating

Karma & Budget Validation

  1. Karma budget - Verify starting karma matches gameplay level (13/25/35)
  2. Positive qualities - Total ≤25 Karma
  3. Negative qualities - Total bonus ≤25 Karma
  4. Karma-to-Nuyen - Verify conversion within level limit
  5. Karma carryover - Remaining ≤7 Karma
  6. Nuyen carryover - Remaining ≤5,000¥

Knowledge & Contact Validation

  1. Knowledge points - Verify total ≤ (INT + LOG) × 2
  2. Contact pool - Verify total ≤ CHA × 3 (contacts only)
  3. Contact limits - Each contact 2-7 Karma (min 1 Con + 1 Loy)

Magic/Resonance Validation (if applicable)

  1. Spell limits - Each category ≤ Magic × 2
  2. Focus count - Bonded foci ≤ Magic
  3. Focus Force - Total Force ≤ Magic × 2
  4. Complex forms - Total ≤ Logic
  5. Bound spirits - Count ≤ Charisma
  6. Registered sprites - Count ≤ Charisma

Validation Output Format

markdown
## Validation Report

### Matched Items (45/50)

All found in `/data/editions/sr5/core-rulebook.json`

### Missing from Database

| Item            | Type       | Suggested Action        |
| --------------- | ---------- | ----------------------- |
| Custom Grip     | Weapon Mod | Add to weaponMods array |
| Ares Roto-Drone | Drone      | Add to drones array     |

### Calculation Discrepancies

| Calculation | Expected | Actual   | Discrepancy |
| ----------- | -------- | -------- | ----------- |
| Essence     | 0.88     | 0.76     | 0.12        |
| Resources   | 450,000¥ | 435,000¥ | 15,000¥     |

### Capacity Violations

| Container      | Capacity | Used | Overflow |
| -------------- | -------- | ---- | -------- |
| Right Cyberarm | 15       | 17   | 2        |

### Common Transcription Errors Detected

- "Ares Predator 5" → Should be "Ares Predator V"
- "Wired Reflexes Rating 2" → Check if essence matches Rating 2 (3.0)
- "Smartlink" → Verify if internal (capacity 0) or external (mount required)

Complete Workflow

Phase 1: Receive Input

  1. User provides archetype name, metatype, and stat block image
  2. Confirm source book and page number

Phase 2: Extract Data

  1. Read all attributes from stat block
  2. Read all skills and specializations
  3. Read all qualities (positive and negative)
  4. Read all equipment with costs
  5. Read all augmentations with grades
  6. Note any contacts

Phase 3: Build Hierarchy

  1. Group weapons with their mods and ammo
  2. Group armor with its mods
  3. Group cyberlimbs with their enhancements
  4. Group cyber eyes/ears with their enhancements
  5. Group drones with their autosofts and weapons
  6. Group SINs with their licenses

Phase 4: Calculate Priorities

  1. Calculate attribute points spent
  2. Calculate skill points and groups
  3. Sum all resource costs
  4. Determine magic/resonance path
  5. Determine metatype special points
  6. Generate priority table with confidence scores

Phase 5: Validate

  1. Check all items against database
  2. Verify calculations (essence, capacity, costs)
  3. Flag missing items and discrepancies
  4. Generate validation report

Phase 6: Generate Markdown

  1. Create markdown file at docs/data_tables/creation/example-character-{slug}-v1.md
  2. Include all sections with proper hierarchy
  3. Include priority inference section
  4. Include validation report

Phase 7: Generate PDF

  1. Convert markdown to PDF using md-to-pdf
  2. Output PDF to same directory as markdown file
  3. Verify PDF was created successfully

Command:

bash
cd docs/data_tables/creation && npx --yes md-to-pdf example-character-{slug}-v{version}.md

This generates example-character-{slug}-v{version}.pdf alongside the markdown file.

Phase 8: Report

  1. Summarize what was imported
  2. List any items needing database addition
  3. List any calculation discrepancies
  4. Provide paths to both markdown and PDF files
  5. Recommend next steps

Reference Files

File Purpose
/data/editions/sr5/core-rulebook.json Database for validation
/docs/data_tables/creation/priority_table.md Priority values
/lib/types/character.ts Grade multipliers, gear types
/lib/types/edition.ts Catalog item schemas
/docs/data_tables/creation/example-character-*.md Format examples (exclude -v.md)

Key Files for Quick Reference

See REFERENCE.md in this skill directory for:

  • Priority tables (all 5 categories)
  • Metatype base attributes
  • Cyberware grade multipliers
  • Cyberlimb capacity by type
  • Common hierarchy patterns
  • Validation checklist

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results