shipshitdev/nextra-writer
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.
$ install --global
skillsauthnpx skillsauth add shipshitdev/library nextra-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 4, 2026, 6:38 AM301.1s3 files scanned
SKILL.md
- name:
- nextra-writer
- description:
- 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.
- version:
- 1.0.0
- tags:
- documentation, nextra, nextjs, mdx, technical-writing, api-docs, react, typescript
Nextra Technical Writer
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.
When This Activates
- Creating or updating Nextra documentation (.md, .mdx)
- Configuring Nextra settings (next.config.mjs, theme.config.tsx)
- Writing API documentation
- Organizing documentation structure and navigation
- Setting up documentation search and navigation
Tech Stack
| Technology | Version | |------------|---------| | Nextra | 3.x | | Next.js | 14.x / 15.x | | React | 18.x / 19.x | | TypeScript | 5.x | | MDX | 3.x |
Quick Start
# 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
Project Structure
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
Navigation
Configure via _meta.json:
{
"index": "Introduction",
"getting-started": "Getting Started",
"---": {
"type": "separator"
},
"api": "API Reference"
}
Key Features
| Feature | Pattern |
|---------|---------|
| Callouts | <Callout type="info"> |
| Tabs | <Tabs items={['npm', 'yarn']}> |
| Cards | <Cards> component |
| Steps | <Steps> component |
| File Tree | <FileTree> component |
Documentation Hierarchy
- Quick Start (5-10 min)
- Core Concepts
- Feature Documentation
- Guides & Tutorials
- API Reference
- Advanced Topics
Integration
| 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
Related Skills
shipshitdev/weekly-review
development
VerifiedTrustedCommunity
Coordinates a weekly engineering review of board accuracy, recent code changes, operational health, and scoped cleanup. Use for a recurring repository health review or a review of the last several days.
35SKILL.mdUpdated Sep 6, 2026
shipshitdev/project-board
testing
VerifiedTrustedCommunity
Audits project board configuration and prepares explicitly requested setup, copy, or normalization changes while preserving the existing workflow and provider boundaries. Use when inspecting a board's fields, columns, scope, or configuration.
35SKILL.mdUpdated Sep 6, 2026
shipshitdev/board-sync
testing
VerifiedTrustedCommunity
Reconciles a project board with current work and delivery evidence, reports incomplete coverage and metadata gaps, and applies only approved provider-supported field changes. Use when auditing board drift, reviewing blocked work, or assessing upcoming delivery.
35SKILL.mdUpdated Sep 6, 2026
shipshitdev/how
development
VerifiedTrustedCommunity
Walk through how a subsystem works. Use for "how does X work", code walkthroughs before changing something, and placement or ownership questions. Explains architecture, runtime flow, and onboarding mental models. Can critique architecture. Use why for motivation.
35SKILL.mdUpdated Aug 31, 2026