optimize-solution

Analyze IoT solution documentation for clarity gaps and terminology inconsistencies.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/suharvest/app_collaboration --skill optimize-solution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-solution
Source: https://github.com/suharvest/app_collaboration/tree/main/.claude/skills/solution-copywriting
Command: npx skills add https://github.com/suharvest/app_collaboration --skill optimize-solution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits and revises IoT solution documentation to be clear to non-technical stakeholders, ensuring descriptions, deployment guides, and bilingual pages align with established terminology and structure.

Core Features & Use Cases

  • Identifies gaps in introduction pages and deployment guides, improving clarity and reducing ambiguity.
  • Checks cross-language consistency between description.md and description_zh.md, and aligns key terms.
  • Produces an actionable improvement report with prioritized issues (P0/P1/P2) and suggested edits.

Quick Start

Run the skill against a target solution folder, for example:

  • /optimize-solution smart_warehouse

Frequently Asked Questions about optimize-solution

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve IoT solution documentation for non-technical users?

To improve IoT solution documentation for non-technical users, analyze description.md and guide.md files to identify clarity gaps and terminology inconsistencies. This process outputs an actionable plan with prioritized issues and suggested edits.

What is cross-language alignment for IoT docs and how does it work?

Cross-language alignment for IoT docs checks consistency between description.md and description_zh.md files. It evaluates bilingual pages to align key terms and ensures both languages convey established terminology and structure accurately.

How do I audit deployment guides in a solutions directory for readability?

To audit deployment guides in a solutions directory, evaluate guide.md files for non-technical readability and ambiguity. This identifies gaps in deployment instructions and produces a prioritized report with suggested edits to improve clarity.

Can I validate frontmatter and structure in IoT solution folders?

Yes, you can validate frontmatter and structure in IoT solution folders. Analyzing the solutions directory validates the structural format of description.md, description_zh.md, and guide.md while checking for cross-language alignment.

What is the best way to prioritize documentation issues in IoT projects?

The best way to prioritize documentation issues in IoT projects is to generate an actionable improvement report that categorizes problems by severity. This assigns P0, P1, or P2 priority levels and provides suggested edits.

Related Skills