content-strategy
Documentation architecture, content planning, and maintenance strategies
What this skill does
# Content Strategy ## Documentation Architecture and Information Hierarchy ### Information Architecture Principles - **User-Centered Design**: Organize content around user needs and tasks - **Scannability**: Make content easy to scan with headings, lists, and formatting - **Findability**: Ensure users can find information through search and navigation - **Consistency**: Use consistent structure and terminology throughout - **Progressive Disclosure**: Reveal information as needed, not all at once ### Content Organization - **Topic-Based Authoring**: Create reusable content modules - **Hierarchical Structure**: Organize content from general to specific - **Cross-References**: Link related content for comprehensive coverage - **Navigation**: Provide clear navigation paths and breadcrumbs - **Taxonomy**: Use consistent categorization and tagging ### Content Types - **Conceptual Content**: Explains concepts and principles - **Task-Based Content**: Step-by-step instructions for tasks - **Reference Content**: Quick reference for commands, APIs, parameters - **Troubleshooting Content**: Solutions to common problems - **Tutorial Content**: Learning materials and examples ## Content Planning and Roadmaps ### Documentation Planning - **Audience Analysis**: Identify target audiences and their needs - **Content Audit**: Review existing documentation for gaps and quality - **Prioritization**: Prioritize content based on user needs and business goals - **Resource Planning**: Allocate time and resources for documentation - **Timeline**: Create realistic timelines for documentation projects ### Content Roadmaps - **Short-Term**: Immediate documentation needs and quick wins - **Medium-Term**: Planned documentation improvements and expansions - **Long-Term**: Strategic documentation initiatives and goals - **Milestones**: Key milestones and deliverables - **Dependencies**: Identify dependencies between documentation tasks ### Content Calendar - **Publishing Schedule**: Plan when to publish new content - **Update Schedule**: Plan when to review and update existing content - **Seasonal Content**: Plan content around product releases and events - **Content Themes**: Organize content around themes or topics - **Owner Assignment**: Assign owners for each content piece ## Documentation Maintenance Strategies ### Content Review Cycles - **Regular Reviews**: Schedule regular content reviews (quarterly, biannually) - **Version Updates**: Update documentation with each product release - **User Feedback**: Review and incorporate user feedback - **Analytics Review**: Review analytics to identify underperforming content - **Competitive Analysis**: Review competitor documentation for improvements ### Content Lifecycle - **Creation**: Write and publish new content - **Maintenance**: Keep content accurate and up-to-date - **Archival**: Archive outdated or obsolete content - **Deletion**: Remove content that is no longer needed - **Revival**: Revive and update archived content if needed ### Quality Assurance - **Peer Review**: Have peers review documentation before publishing - **User Testing**: Test documentation with actual users - **Accuracy Checks**: Verify technical accuracy regularly - **Link Checking**: Check for broken links regularly - **Accessibility**: Ensure content is accessible to all users ## Localization and Internationalization ### Internationalization (i18n) - **Unicode Support**: Use Unicode for international character support - **Text Direction**: Support left-to-right and right-to-left languages - **Date/Time Formats**: Use locale-appropriate date and time formats - **Number Formats**: Use locale-appropriate number and currency formats - **String Externalization**: Externalize strings for translation ### Localization (l10n) - **Translation**: Translate content into target languages - **Cultural Adaptation**: Adapt content for cultural appropriateness - **Terminology**: Use consistent terminology in each language - **Images and Screenshots**: Localize images and screenshots - **Testing**: Test localized content for accuracy and usability ### Localization Strategy - **Priority Languages**: Identify priority languages based on user base - **Translation Tools**: Use translation management systems - **Translation Process**: Establish translation workflow and review process - **Maintenance**: Keep translations synchronized with source content - **Quality Assurance**: Review translations for accuracy and quality ## Documentation Metrics and KPIs ### Usage Metrics - **Page Views**: Track page views and unique visitors - **Time on Page**: Measure engagement and reading time - **Bounce Rate**: Identify pages with high exit rates - **Search Queries**: Track what users are searching for - **Click-Through Rate**: Measure navigation effectiveness ### Quality Metrics - **Documentation Coverage**: Percentage of features documented - **Accuracy**: Percentage of accurate information - **Completeness**: Percentage of complete documentation - **Readability**: Flesch-Kincaid reading level scores - **User Satisfaction**: User satisfaction scores and ratings ### Business Metrics - **Support Reduction**: Reduction in support tickets - **Time to Answer**: Average time to find answers - **User Onboarding**: Improvement in user onboarding time - **Feature Adoption**: Increase in feature adoption - **Customer Retention**: Impact on customer retention ### KPIs - **Documentation ROI**: Return on investment for documentation efforts - **Documentation Velocity**: Rate of documentation creation and updates - **Search Success Rate**: Percentage of successful searches - **Content Freshness**: Age of documentation content - **User Engagement**: User engagement with documentation ## User Feedback Integration ### Feedback Channels - **Feedback Forms**: Collect feedback directly on documentation pages - **Surveys**: Conduct periodic user surveys - **Support Tickets**: Analyze support tickets for documentation gaps - **User Interviews**: Conduct user interviews for deeper insights - **Analytics**: Analyze user behavior through analytics ### Feedback Analysis - **Categorization**: Categorize feedback by type and severity - **Prioritization**: Prioritize feedback based on impact and effort - **Trend Analysis**: Identify trends and patterns in feedback - **Root Cause Analysis**: Identify root causes of documentation issues - **Action Planning**: Create action plans to address feedback ### Feedback Implementation - **Quick Wins**: Address quick and easy improvements immediately - **Planned Updates**: Incorporate feedback into planned documentation updates - **Communication**: Communicate changes to users - **Validation**: Validate that changes address user needs - **Continuous Improvement**: Establish continuous improvement process
Related in Writing & Docs
jax-development
IncludedUse this skill when the user is writing, debugging, profiling, refactoring, reviewing, benchmarking, parallelising, exporting, or explaining JAX code, or when they mention JAX, jax.numpy, jit, grad, value_and_grad, vmap, scan, lax, random keys, pytrees, jax.Array, sharding, Mesh, PartitionSpec, NamedSharding, pmap, shard_map, Pallas, XLA, StableHLO, checkify, profiler, or the JAX repo. It helps turn NumPy or PyTorch-style code into pure functional JAX, fix tracer/control-flow/shape/PRNG bugs, remove recompiles and host-device syncs, choose transforms and sharding strategies, inspect jaxpr/lowering/IR, and benchmark compiled code correctly.
nature-article-writer
IncludedDrafts, rewrites, diagnostically critiques, and style-calibrates primary research manuscripts for Nature and Nature Portfolio journals. Use when the user wants a Nature-style title, summary paragraph or abstract, introduction, results, discussion, methods, figure legends, presubmission enquiry, cover letter, reviewer response, or when a scientific draft sounds generic, jargon-heavy, structurally weak, or AI-ish and needs precise, broad-reader-friendly prose without inventing data, analyses, or references. Best for primary research articles and letters rather than reviews or press releases unless explicitly adapting one.
deckrd
IncludedDocument-driven framework that derives requirements, specifications, implementation plans, and executable tasks from goals through structured AI dialogue. Use when user says "write requirements", "create spec", "plan implementation", "derive tasks", "structure this feature", "break down into tasks", or "document this module". Also use for reverse engineering existing code into docs (/deckrd rev). Do NOT use for direct code writing — use /deckrd-coder after tasks are generated. Do NOT use when the user only wants to run or fix existing code without planning.
clinical-decision-support
IncludedGenerate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
handling-sf-data
IncludedSalesforce data operations with 130-point scoring. Use this skill to create, update, delete, bulk import/export, generate test data, and clean up org records using sf CLI and anonymous Apex. TRIGGER when: user creates test data, performs bulk import/export, uses sf data CLI commands, needs data factory patterns for Apex tests, or needs to seed/clean records in a Salesforce org. DO NOT TRIGGER when: SOQL query writing only (use querying-soql), Apex test execution (use running-apex-tests), or metadata deployment (use deploying-metadata).
accelint-ac-to-playwright
IncludedConvert and validate acceptance criteria for Playwright test automation. Use when user asks to (1) review/evaluate/check if AC are ready for automation, (2) assess if AC can be converted as-is, (3) validate AC quality for Playwright, (4) turn AC into tests, (5) generate tests from acceptance criteria, (6) convert .md bullets or .feature Gherkin files to Playwright specs, (7) create test automation from requirements. Handles both bullet-style markdown and Gherkin syntax with JSON test plan generation and validation.