# Qubit Mapper

> Qubit mapping and routing skill for hardware topology optimization

- Skill: `a5c-ai/qubit-mapper` (Agent Skill)
- Install (CLI): `npx skillmds@latest add a5c-ai/qubit-mapper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/a5c-ai/qubit-mapper/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: a5c-ai (https://skillmd.com/u/a5c-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/a5c-ai/qubit-mapper

---


# Qubit Mapper

## Purpose

Provides expert guidance on mapping logical qubits to physical hardware while respecting connectivity constraints and minimizing SWAP overhead.

## Capabilities

- Initial qubit placement
- SWAP gate insertion
- Routing optimization algorithms
- Topology-aware compilation
- Noise-aware placement
- Heavy-hex and grid topology support
- Dynamic circuit routing
- Parallel SWAP optimization

## Usage Guidelines

1. **Topology Analysis**: Understand target hardware connectivity graph
2. **Initial Placement**: Use heuristics for initial logical-physical mapping
3. **Routing**: Insert SWAPs to enable non-native interactions
4. **Optimization**: Minimize SWAP count and circuit depth
5. **Noise Consideration**: Prefer high-fidelity qubits and links

## Tools/Libraries

- Qiskit
- pytket (t|ket>)
- Cirq
- BQSKit
- NetworkX