# Documentation Improvement

> Documentation Issue

- Skill: `tools-only/documentation-improvement-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/documentation-improvement-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/documentation-improvement-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tools-only/documentation-improvement-2

---


## Documentation Issue

**File(s) Affected:** (e.g., README.md, CLAUDE.md, specific SKILL.md)
**Section:** (e.g., Installation, Quick Start, Roadmap)

## Issue Type

Select one or more:
- [ ] Unclear instructions
- [ ] Missing information
- [ ] Outdated content
- [ ] Broken links
- [ ] Typos or grammar
- [ ] Missing examples
- [ ] Incorrect information
- [ ] Needs reorganization
- [ ] Other (specify)

## Current Problem

**What is unclear, missing, or incorrect?**

Describe the documentation issue in detail.

## Proposed Improvement

**What should be changed?**

Describe the proposed documentation improvement.

## Specific Changes

### If Fixing Content:
**Current Text:**
```
[Paste current text that needs fixing]
```

**Proposed Text:**
```
[Paste proposed improved text]
```

### If Adding New Section:
**Where to Add:** (After which section)
**Proposed Content:**
```markdown
[Paste proposed new section]
```

### If Reorganizing:
**Current Structure:**
- Section 1
- Section 2

**Proposed Structure:**
- Section A
- Section B

## Affected Audience

**Who would benefit from this improvement?**

- [ ] New users getting started
- [ ] Experienced users seeking advanced features
- [ ] Contributors wanting to add skills
- [ ] Developers using Python tools
- [ ] All users

## Additional Context

- Screenshots showing the issue
- Links to related documentation
- Examples from other projects
- User feedback or questions

## Checklist

- [ ] I have checked this is not already fixed in main branch
- [ ] I have specified exactly what should change
- [ ] I have considered the impact on other documentation
- [ ] I'm willing to submit a PR for this (optional)