skills.rest
allemaar
allemaarCOMMUNITY
Explore all skills by this author →
Website𝕏@allemaarGitHub

map-this

Audit and organize a bounded folder or vault into a navigable map graph with read-only proposals.

14|1|Updated Jun 14, 2026
Search Tags:#markdown#knowledge management#audit#obsidian#link resolution#vault organization#file mapping
One-click install
npx skills add https://github.com/allemaar/open-skills --skill map-this-allemaar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-this
Source: https://github.com/allemaar/open-skills/tree/main/skills/map-this
Command: npx skills add https://github.com/allemaar/open-skills --skill map-this-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Folders, projects, and note vaults accumulate unstructured files with broken links, duplicate tags, and no clear ownership, making navigation and maintenance painful. This Skill performs a read-only audit of a bounded scope, then presents simple, selectable proposals so nothing changes without explicit approval. ## Core Features & Use Cases - Deterministic pre-assessment scan: Runs a bundled read-only scanner that fingerprints the inventory, detects broken links, case-fold collisions, orphan files, and contract errors before any judgment is applied. - Coverage ledger with verdicts: Every in-scope file lands in exactly one of ASSESSED, EXCLUDED, RESIDUAL, or UNREADABLE buckets, producing COMPLETE, PARTIAL, or BLOCKED verdicts with no silent omissions. - Handler-selected proposals: Link healing, retargeting, alias creation, archive, README care, and exclusion declarations are presented as risk-grouped rows applied only after selection, with preimage checks and resume-safe idempotent writes. - Use Case: Point it at a messy Obsidian vault or project folder, receive a zero-write assessment with findings and a proposal table, then approve only the renames, link repairs, and map assignments you want. ## Quick Start Ask the agent to map this project by running the map-this workflow on a chosen folder to get a read-only audit and a table of selectable organization proposals.

Frequently Asked Questions about map-this

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

FAQPage Schema
How do I organize a messy folder or note vault with an AI agent?▼

Run the map-this workflow on the target path. It scans the inventory read-only, audits frontmatter, links, tags, and map ownership, then presents risk-grouped proposals you individually accept, reject, or defer before any file changes.

How to find and fix broken links in a Markdown vault?▼

The bundled map-scan tool resolves every wikilink and relative Markdown link against the canonical inventory, classifying occurrences as resolved, missing, ambiguous, or accepted. Repair proposals include alias creation, evidence-graded retargeting, and disambiguation menus.

Does map-this modify files automatically during the audit?▼

No. The audit phase is strictly read-only and the first output is always a zero-write assessment. Mutations happen only for rows the Handler explicitly selects, applied with preimage re-reads, symlink refusal, and idempotent resume-safe steps.

Can I use map-this with Obsidian or non-Lyt vaults?▼

Yes. A dedicated environment branch covers non-Lyt Markdown and Obsidian vaults, following the vault's own frontmatter and write conventions. Lyt-specific indexing and capture claims are never made outside a registered Lyt vault.

What happens when the scan cannot cover every file?▼

The coverage ledger forces every in-scope path into ASSESSED, EXCLUDED, RESIDUAL, or UNREADABLE buckets. If caps or unreadable files prevent full coverage, the verdict is PARTIAL or BLOCKED rather than COMPLETE, and no cleanliness claim is made.

Related Skills

Explore More Product & Management Skills→
pageelpageel
48

PARA Kit

Define the four-pillar PARA workspace structure and v1.6.3 project.md schema.

Official
Basic
SAZO-KRSAZO-KR

review

Launch five parallel fresh-context code review agents until all pass.

Official
Advanced
braydos-hbraydos-h
4

exploiting-broken-link-hijacking

Detect broken link hijacking and subdomain takeover risks in web applications.

Community
Intermediate
humanerd-drewhumanerd-drew
2

vault-naming-convention

Enforces unique .md basenames and standardizes wikilinks for Obsidian vaults.

Official
Advanced