---
name: Documentation Improvement
about: Suggest improvements to documentation
title: '[DOCS] '
labels: documentation
assignees: ''
---

## 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)