# Source Maps

> Source Maps is an Agent Skill for testing & quality published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Expert skill for generating and consuming source maps for debugging compiled code

- Skill name: `Source Maps`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/programming-languages/skills/source-maps/SKILL.md
- Repository: a5c-ai/babysitter (1,548 GitHub stars when collected)

## SKILL.md

# Source Maps Skill

## Overview

Expert skill for generating and consuming source maps for debugging compiled code.

## Capabilities

- Generate source maps in various formats (V3 JSON, DWARF)
- Map generated positions to original source
- Handle inlined functions in source maps
- Implement source map composition/chaining
- Generate VLQ-encoded mappings
- Support names array for identifiers
- Handle multi-file source map indices
- Integrate with debuggers and stack traces

## Target Processes

- source-map-generation.js
- code-generation-llvm.js
- debugger-adapter-development.js
- jit-compiler-development.js

## Dependencies

Source map V3 specification

## Usage Guidelines

1. **Accuracy**: Ensure precise mapping between generated and original positions
2. **Inlining**: Handle inlined code with multiple source locations
3. **Composition**: Support chaining for multi-stage compilation
4. **Efficiency**: Use VLQ encoding for compact representations
5. **Integration**: Test with actual debuggers to verify correctness

## Output Schema

```json
{
  "type": "object",
  "properties": {
    "format": {
      "type": "string",
      "enum": ["v3-json", "dwarf", "pdb"]
    },
    "features": {
      "type": "array",
      "items": { "type": "string" }
    },
    "inlineSupport": { "type": "boolean" },
    "generatedFiles": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}
```

---

Source: https://www.openparable.com/skill/testing-quality/source-maps-08cd5f94 (OpenParable). Cite the canonical URL above.
