# Markdowntown Atlas Scan

> Atlas Simulator scan flow and next-step guidance for markdowntown. Use when working on folder scanning, tool detection, cwd handling, results panels, or scan-to-workbench CTAs.

- Skill: `diegosouzapw/markdowntown-atlas-scan` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/markdowntown-atlas-scan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/markdowntown-atlas-scan/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/markdowntown-atlas-scan

---


# markdowntown-atlas-scan

## Core workflow
1. Confirm entry points to `/atlas/simulator` and the primary scan action.
2. Validate tool detection and cwd behavior for ancestor-scanning tools.
3. Ensure results highlight missing/loaded files and scan metadata.
4. Keep the Next steps panel prominent and action-oriented.
5. Route users into Workbench with scan context intact.

## Guardrails
- Scans are local-only; do not upload file contents.
- Handle permission errors, empty scans, and truncated scans with clear copy.
- Prefer one primary CTA per results state.

## References
- docs/atlas/simulator.md
- docs/atlas/scan-next-steps.md
- docs/architecture/atlas-simulator-flow.md
- docs/ui/scan-flow.md
- codex/skills/markdowntown-atlas-scan/references/atlas-docs.md
- codex/skills/markdowntown-atlas-scan/references/atlas-source.md