Skip to content

docs: enhance guides with navigation, skill best practices, and README cleanup#133

Merged
shinpr merged 1 commit intomainfrom
improve/docs-navigation-and-skill-guide
Feb 23, 2026
Merged

docs: enhance guides with navigation, skill best practices, and README cleanup#133
shinpr merged 1 commit intomainfrom
improve/docs-navigation-and-skill-guide

Conversation

@shinpr
Copy link
Owner

@shinpr shinpr commented Feb 23, 2026

Summary

  • Quickstart (EN/JA): Added "What's Next?" table linking common tasks to solutions, and library docs placement guidance with cross-references to use-cases and skills-editing-guide
  • Use Cases (EN/JA): Added customization use cases — how to add library docs (with context-dependent decision framework) and team-specific rules as skills
  • Skills Editing Guide (EN/JA): Expanded with naming conventions (gerund form), description best practices (third-person voice, activation rate data, good/bad examples from official docs, 1024-char constraint), and file reference depth guidance
  • README (EN/JA): Updated Skills Editing Guide description, added library docs FAQ, consolidated slash commands table (frontend commands as footnote), replaced sub agents roster table with summary + link
  • Overlap resolution: Quickstart now links to use-cases for detailed library docs decision table instead of duplicating it

Test plan

  • Verify all cross-document links resolve correctly (quickstart → use-cases, quickstart → skills-editing-guide, use-cases → skills-editing-guide)
  • Confirm README anchor links in table of contents still work after section name changes
  • Review EN/JA content parity — same structure and information in both languages
  • Check that no information was lost — detailed content moved to linked pages, not deleted

🤖 Generated with Claude Code

…E cleanup

- Add "What's Next?" table and library docs placement guidance to quickstart (EN/JA)
- Add customization use cases (library docs, team rules) to use-cases (EN/JA)
- Expand skills-editing-guide with naming conventions, description best practices,
  activation rate data, good/bad examples, and file reference depth (EN/JA)
- Update README Skills Editing Guide description to reflect practical use cases
- Add library docs FAQ entry to README (EN/JA)
- Consolidate slash commands table (frontend commands as footnote)
- Replace sub agents roster table with summary + link
- Resolve content overlap between quickstart and use-cases

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@shinpr shinpr self-assigned this Feb 23, 2026
@shinpr shinpr merged commit c49f693 into main Feb 23, 2026
1 check passed
@shinpr shinpr deleted the improve/docs-navigation-and-skill-guide branch February 23, 2026 04:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant