Add 260+ Claude Code skills from skills.sh
Complete collection of AI agent skills including: - Frontend Development (Vue, React, Next.js, Three.js) - Backend Development (NestJS, FastAPI, Node.js) - Mobile Development (React Native, Expo) - Testing (E2E, frontend, webapp) - DevOps (GitHub Actions, CI/CD) - Marketing (SEO, copywriting, analytics) - Security (binary analysis, vulnerability scanning) - And many more... Synchronized from: https://skills.sh/ Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
95
document-writer/skill.md
Normal file
95
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