bundles/content/skills/nextra-writer/SKILL.md
Expert in creating clear, comprehensive technical documentation with Nextra (Next.js-based docs framework), MDX, and modern documentation patterns. Use for documentation sites that need Next.js integration.
npx skillsauth add shipshitdev/library nextra-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Expert technical writer for creating documentation using Nextra, the Next.js-based documentation framework.
Why Nextra: Next.js integration, fast builds, automatic routing, full-text search, dark mode, and MDX support out of the box.
| Technology | Version | |------------|---------| | Nextra | 3.x | | Next.js | 14.x / 15.x | | React | 18.x / 19.x | | TypeScript | 5.x | | MDX | 3.x |
# Create new Nextra docs
bun create next-app docs --example nextra-docs-template
# Or add to existing Next.js project
bun add nextra nextra-theme-docs
docs/
├── pages/
│ ├── _meta.json # Navigation config
│ ├── index.mdx # Home page
│ ├── getting-started.mdx
│ └── api/
│ ├── _meta.json
│ └── endpoints.mdx
├── theme.config.tsx # Theme configuration
├── next.config.mjs # Next.js + Nextra config
└── package.json
Configure via _meta.json:
{
"index": "Introduction",
"getting-started": "Getting Started",
"---": {
"type": "separator"
},
"api": "API Reference"
}
| Feature | Pattern |
|---------|---------|
| Callouts | <Callout type="info"> |
| Tabs | <Tabs items={['npm', 'yarn']}> |
| Cards | <Cards> component |
| Steps | <Steps> component |
| File Tree | <FileTree> component |
| Skill | When to Use |
|-------|-------------|
| docs | General technical writing |
| api-design-expert | API documentation structure |
| frontend-design | Custom documentation UI |
For detailed configuration, MDX patterns, and component examples: references/full-guide.md
testing
Use this skill when users need to validate a launch plan, assess MVP scope, or determine if they're ready to execute. Activates for "validate my plan," "am I ready to launch," "is my scope too big," or when assessing action readiness.
testing
Use this skill when users are stuck on a decision, overthinking, experiencing analysis paralysis, or need to ship faster. Activates for "should I wait," "I can't decide," "I'm overthinking," or when speed is critical and perfectionism is the enemy.
development
Use this skill when users need to make early hires, build their founding team, determine compensation/equity, decide who to hire first, or scale from founders to first employees. Activates for "who should I hire first," "early hiring," "equity for employees," or team building questions.
data-ai
Use this skill when users need to remove customer friction, improve customer success, handle objections, design guarantees, or eliminate obstacles between customers and results. Activates for customer success issues, objection handling, or "customers can't get results" problems.