Skip to content
This repository was archived by the owner on Mar 20, 2026. It is now read-only.

feat: add task-doc-writer skill#37

Merged
mkmeral merged 1 commit intomainfrom
feature/task-doc-writer-skill
Mar 20, 2026
Merged

feat: add task-doc-writer skill#37
mkmeral merged 1 commit intomainfrom
feature/task-doc-writer-skill

Conversation

@agent-of-mkmeral
Copy link
Copy Markdown
Owner

Summary

Adds a new task-doc-writer skill based on strands-agents/devtools PR #24.

This skill enables the agent to produce high-quality documentation updates based on tasks described in GitHub issues, following the Strands style guide.

What it does

The doc writer skill provides a comprehensive SOP for:

  • Task Understanding: Reading issues, researching source code, checking cross-SDK parity (Python/TypeScript)
  • Documentation Planning: Studying existing docs, identifying document types, planning content structure
  • Code Examples: Developing and testing all code examples before inclusion
  • Writing: Following the Strands voice, tone, formatting standards (MkDocs Material admonitions, tabbed code blocks, etc.)
  • Quality Verification: Built-in quality checklist covering voice/tone, writing style, structure, code, formatting, and links
  • PR Workflow: Creating feature branches, conventional commits, and pull requests
  • Feedback Loop: Iterating on review comments

Skill Details

  • Name: task-doc-writer
  • Allowed Tools: shell, use_github, retrieve
  • Location: skills/task-doc-writer/SKILL.md
  • Lines: 552 (comprehensive style guide included)

Source

Based on the doc writer SOP from strands-agents/devtools#24, adapted to the strands-coder skill format with proper YAML frontmatter.

Closes #36

Add documentation writer skill based on strands-agents/devtools PR #24.
This skill enables the agent to produce high-quality documentation
updates based on GitHub issues, following the Strands style guide.

Capabilities:
- Research source code and existing docs
- Check cross-SDK feature parity (Python/TypeScript)
- Plan documentation structure with user approval
- Develop and test code examples
- Write docs following Strands voice, tone, and formatting standards
- Create pull requests with conventional commit messages
- Iterate on review feedback

Closes #36
@mkmeral mkmeral merged commit ec84a36 into main Mar 20, 2026
2 checks passed
@agent-of-mkmeral agent-of-mkmeral mentioned this pull request Mar 20, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

doc writing skill

2 participants