playbooks

home / skills / d-oit / do-novelist-ai / writing-assistant

writing-assistant skill

/.opencode/skill/writing-assistant

This skill assists writing tasks with real-time style analysis, grammar checks, goal tracking, and inline suggestions to improve quality and productivity.

npx playbooks add skill d-oit/do-novelist-ai --skill writing-assistant

Review the files below or copy the command above to add this skill to your agents.

Files (7)
SKILL.md
2.3 KB
---
name: writing-assistant
description:
  Work on writing assistance features including real-time style analysis,
  grammar checking, writing goals tracking, inline suggestions, and writing
  analytics. Use when implementing linguistic analysis, productivity tracking,
  or writing quality tools.
---

# Writing Assistant

## Quick Reference

- **[Style Analysis](style-analysis.md)** - Voice consistency and tone detection
- **[Grammar System](grammar-system.md)** - Suggestions and error detection
- **[Goals Tracking](goals-tracking.md)** - Targets, streaks, and achievements
- **[Writing Analytics](writing-analytics.md)** - Metrics and productivity
  insights

## When to Use

- Implementing real-time style or tone analysis
- Building grammar checking or suggestion systems
- Creating writing goals or productivity tracking
- Working on inline suggestions or feedback
- Analyzing writing patterns or metrics
- Detecting voice consistency issues

## Core Methodology

- **Linguistic Analysis**: Apply NLP patterns for style and grammar
- **Real-time Processing**: Analyze text efficiently as user types
- **Goal Tracking**: Use gamification for motivation and progress
- **Feedback Quality**: Provide actionable, context-aware suggestions
- **Performance**: Optimize for responsive real-time analysis

## Integration

- **tech-stack-specialist**: Manage NLP libraries and analysis tools
- **qa-engineer**: Test linguistic accuracy and edge cases
- **performance-engineer**: Optimize real-time analysis performance
- **architecture-guardian**: Separate analysis logic from UI
- **domain-expert**: Model writing concepts and metrics

## Best Practices

✓ Provide explanations for all suggestions ✓ Maintain user preferences and
writing style profile ✓ Use debouncing for real-time analysis ✓ Cache analysis
results where appropriate ✓ Support multiple writing styles and genres

## Content Modules

See detailed modules:

- **[Style Analysis](style-analysis.md)**: Voice, tone, and consistency
  detection
- **[Grammar System](grammar-system.md)**: Error detection and suggestions
- **[Goals Tracking](goals-tracking.md)**: Daily targets, streaks, achievements
- **[Writing Analytics](writing-analytics.md)**: Metrics, patterns, insights
- **[Inline Suggestions](inline-suggestions.md)**: Real-time feedback
  implementation

Overview

This skill provides a full-featured writing assistant for real-time style analysis, grammar checking, goal tracking, inline suggestions, and writing analytics. It helps developers add responsive, context-aware feedback and productivity features to writing apps. The implementation focuses on performance, explainable suggestions, and adaptable writing profiles.

How this skill works

The system applies linguistic analysis and NLP patterns to detect tone, voice consistency, grammar errors, and stylistic issues as users type. It runs lightweight, debounced real-time checks, caches results, and surfaces inline suggestions with short explanations and confidence scores. Goal tracking and analytics aggregate metrics like streaks, productivity, and common errors to drive personalized recommendations.

When to use it

  • Add live tone, voice, and consistency checks to an editor.
  • Build grammar correction and contextual suggestion systems.
  • Implement writing goals, daily targets, streaks, and achievements.
  • Provide inline, real-time feedback without blocking typing.
  • Collect writing metrics and patterns for productivity insights.
  • Detect and report voice consistency problems across documents.

Best practices

  • Debounce analysis to preserve responsiveness during fast typing.
  • Cache recent analysis results and reuse them across views.
  • Preserve user preferences and a writing style profile for personalization.
  • Provide concise explanations for every suggestion and allow easy dismissal.
  • Separate analysis logic from UI to keep components testable and performant.
  • Support configurable rulesets for different genres and target audiences.

Example use cases

  • Integrate into a web-based editor to show inline grammar fixes and tone nudges.
  • Add a dashboard that tracks daily word-count goals, streaks, and achievements.
  • Run offline style analysis to flag inconsistent voice across a long document.
  • Provide developer-accessible APIs that return suggestions with severity and rationale.
  • Use analytics to surface frequent error types and recommend tailored practice exercises.

FAQ

How do real-time checks avoid slowing the editor?

Use debouncing, incremental analysis, lightweight models, and result caching; run heavy operations off the main thread.

Can suggestions respect a user’s preferred style?

Yes. Maintain a user style profile and allow rule configuration so suggestions align with chosen voice and genre.