markdowntown-atlas-scan

Validate Atlas simulator folder scanning flows and Workbench handoffs.

Updated Dec 31, 2025
One-click install
npx skills add https://github.com/joelklabo/markdowntown-cli --skill markdowntown-atlas-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdowntown-atlas-scan
Source: https://github.com/joelklabo/markdowntown-cli/tree/main/codex/skills/markdowntown-atlas-scan
Command: npx skills add https://github.com/joelklabo/markdowntown-cli --skill markdowntown-atlas-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Atlas simulator scan flows can be inconsistent about entry points, tool detection, working-directory behavior, visible results, and next-step guidance, making it hard for users to understand scan outcomes and continue work in Workbench. This Skill documents the intended scan flow, UX guardrails, and the expectations for preserving scan context when routing users to Workbench.

Core Features & Use Cases

  • Entry point validation: Confirm the simulator entry paths (e.g., /atlas/simulator) and the primary scan action used by the CLI/web.
  • Tool detection & cwd handling: Verify ancestor-scanning tool detection, correct cwd behavior, and reproducible results across scopes.
  • Results & Next Steps: Ensure results panels surface loaded and missing files, scan metadata, clear error states, and a prominent primary CTA that preserves scan context for Workbench handoff.
  • Robust guardrails: Local-only scans, clear handling for permission errors, empty or truncated scans, and guidance to rescan or narrow scope.

Quick Start

Scan the /atlas/simulator folder, confirm tool detection and cwd behavior, surface loaded and missing files with scan metadata, and produce actionable next-step guidance that preserves the scan context for Workbench handoff.

Frequently Asked Questions about markdowntown-atlas-scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate folder scanning flows and tool detection in the Atlas simulator?

Folder scanning flows in the Atlas simulator are validated by confirming entry paths like /atlas/simulator, verifying ancestor-scanning tool detection, and checking cwd behavior to ensure reproducible results across scopes.

How does the Atlas simulator handle permission errors and empty folder scans?

Permission errors and empty folder scans in the Atlas simulator are handled through robust guardrails that surface clear error states and provide guidance to rescan or narrow the scanning scope.

How do I preserve scan context when routing Atlas simulator results to Workbench?

Scan context is preserved for Workbench handoff by providing a single primary call-to-action within the results panel that carries loaded files, missing files, and scan metadata directly into the next step.

What should the Atlas simulator results panel display after a local folder scan?

The results panel should surface loaded and missing files alongside scan metadata, presenting clear error states for truncated scans and a prominent primary CTA to route users into Workbench.

Can I run remote folder scans with the Atlas simulator?

Folder scans are restricted to local-only constraints within the Atlas simulator, meaning remote scanning is not supported and all tool detection and cwd handling must operate on local directories.

Why does my Atlas simulator scan show inconsistent working directory behavior?

Inconsistent cwd behavior occurs when ancestor-scanning tool detection is not properly validated, making it necessary to confirm entry paths and verify working directory handling for reproducible scan results.