# 213 Use 12909537

> Provides a structured README template for documenting XDG config directories, dotfiles, and script folders, helping users remember the purpose and contents of their local configuration.

- Skill: `tools-only/213-use-12909537` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add tools-only/213-use-12909537`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/213-use-12909537/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing, Technical Writing
- Tags: Config Directory, Dotfiles, Readme, Template, Xdg
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/tools-only/213-use-12909537

---

# Config Directory README Template

Use this template for XDG config directories, dotfiles, script folders,
and any local directory you'll return to later wondering "what is this?"

The audience is future-you, probably confused.

---

# [Tool/Directory Name] Config

> Last reviewed: [YYYY-MM-DD]

[One sentence: what this directory configures and why you have custom config]

## What's Here

| Path | Purpose |
|------|---------|
| `[file-or-dir]` | [What it does] |
| `[file-or-dir]` | [What it does] |
| `[file-or-dir]` | [What it does] |

### [Subdirectory 1] (if complex enough to warrant detail)

[Brief explanation of what's in this subdirectory]

### [Subdirectory 2]

[Brief explanation]

## Why This Setup

[1-2 paragraphs explaining your philosophy or goals for this config. What problems were you solving? What workflow are you optimizing for?]

## How to Extend

### Adding a new [thing]

1. [Step 1]
2. [Step 2]
3. [Step 3]

### Adding a new [other thing]

1. [Steps]

## Dependencies

[What needs to be installed for this config to work]

```bash
[Install commands if applicable]
```

## Gotchas

- [Thing that will confuse future-you]
- [Non-obvious behavior]
- [Files that shouldn't be edited directly]
- [Order dependencies or load sequences]

## Sync/Backup

[How this config is backed up or synced across machines, if applicable]

## Related

- [Link to tool's official docs]
- [Link to your dotfiles repo if this is part of it]
- [Other relevant resources]