Reorganize: Move all skills to skills/ folder
- Created skills/ directory - Moved 272 skills to skills/ subfolder - Kept agents/ at root level - Kept installation scripts and docs at root level Repository structure: - skills/ - All 272 skills from skills.sh - agents/ - Agent definitions - *.sh, *.ps1 - Installation scripts - README.md, etc. - Documentation Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
95
skills/document-writer/skill.md
Normal file
95
skills/document-writer/skill.md
Normal file
@@ -0,0 +1,95 @@
|
||||
---
|
||||
name: document-writer
|
||||
description: Use when writing blog posts or documentation markdown files - provides writing style guide (active voice, present tense), content structure patterns, and MDC component usage. Overrides brevity rules for proper grammar. Use nuxt-content for MDC syntax, nuxt-ui for component props.
|
||||
license: MIT
|
||||
---
|
||||
|
||||
# Documentation Writer for Nuxt Ecosystem
|
||||
|
||||
Writing guidance for blog posts and documentation following patterns from official Nuxt websites.
|
||||
|
||||
## When to Use
|
||||
|
||||
- Writing blog posts for Nuxt ecosystem projects
|
||||
- Creating or editing documentation pages
|
||||
- Ensuring consistent writing style across content
|
||||
|
||||
## Writing Standard
|
||||
|
||||
**Override**: When writing documentation, maintain proper grammar and complete sentences. The "sacrifice grammar for brevity" rule does NOT apply here.
|
||||
|
||||
Documentation must be:
|
||||
|
||||
- Grammatically correct
|
||||
- Clear and unambiguous
|
||||
- Properly punctuated
|
||||
- Complete sentences (not fragments)
|
||||
|
||||
Brevity is still valued, but never at the cost of clarity or correctness.
|
||||
|
||||
## Related Skills
|
||||
|
||||
For component and syntax details, use these skills:
|
||||
|
||||
| Skill | Use For |
|
||||
| ---------------- | ----------------------------------------------- |
|
||||
| **nuxt-content** | MDC syntax, prose components, code highlighting |
|
||||
| **nuxt-ui** | Component props, theming, UI patterns |
|
||||
|
||||
## Available References
|
||||
|
||||
| Reference | Purpose |
|
||||
| -------------------------------------------------------------------- | ----------------------------------------------- |
|
||||
| **[references/writing-style.md](references/writing-style.md)** | Voice, tone, sentence structure |
|
||||
| **[references/content-patterns.md](references/content-patterns.md)** | Blog frontmatter, structure, component patterns |
|
||||
|
||||
**Load based on context:**
|
||||
|
||||
- Writing prose → [references/writing-style.md](references/writing-style.md)
|
||||
- Blog structure and patterns → [references/content-patterns.md](references/content-patterns.md)
|
||||
|
||||
## Quick Reference
|
||||
|
||||
### Writing Patterns
|
||||
|
||||
| Pattern | Example |
|
||||
| ------------- | -------------------------------------------------- |
|
||||
| Subject-first | "The `useFetch` composable handles data fetching." |
|
||||
| Imperative | "Add the following to `nuxt.config.ts`." |
|
||||
| Contextual | "When using authentication, configure..." |
|
||||
|
||||
### Modal Verbs
|
||||
|
||||
| Verb | Meaning |
|
||||
| -------- | ----------- |
|
||||
| `can` | Optional |
|
||||
| `should` | Recommended |
|
||||
| `must` | Required |
|
||||
|
||||
### Component Patterns (WHEN to use)
|
||||
|
||||
| Need | Component |
|
||||
| ----------------- | --------------------------------- |
|
||||
| Info aside | `::note` |
|
||||
| Suggestion | `::tip` |
|
||||
| Caution | `::warning` |
|
||||
| Required | `::important` |
|
||||
| CTA | `:u-button{to="..." label="..."}` |
|
||||
| Multi-source code | `::code-group` |
|
||||
|
||||
> For component props: see **nuxt-ui** skill
|
||||
|
||||
## Headings
|
||||
|
||||
- **H1 (`#`)**: No backticks — they don't render properly
|
||||
- **H2-H4**: Backticks work fine
|
||||
|
||||
## Checklist
|
||||
|
||||
- [ ] Active voice (85%+)
|
||||
- [ ] Present tense
|
||||
- [ ] 2-4 sentences per paragraph
|
||||
- [ ] Explanation before code
|
||||
- [ ] File path labels on code blocks
|
||||
- [ ] Appropriate callout types
|
||||
- [ ] No backticks in H1 headings
|
||||
Reference in New Issue
Block a user