Write technical articles with web research, runnable examples, and translations in author's voice
Detected risks:
The article-writer skill is designed to help users create high-quality technical articles by combining in-depth research, companion projects, and multi-language support. It focuses on producing articles that not only explain technical concepts but also provide runnable code examples and detailed companion projects. This skill addresses the need for well-researched, engaging, and practical content that can be used by a wide audience, especially for technical documentation or tutorials.
Key features include an organized workflow, starting from author identification and planning, followed by research, drafting, and creating companion projects. The skill allows for structured phases that ensure the content is well-planned, researched, and refined. It also includes multi-language translation support to expand the reach of the content. Additionally, the skill personalizes the writing based on the author's profile, allowing for consistent tone, vocabulary, and style, which is crucial for maintaining the author's voice across different articles. The result is a seamless experience that produces polished technical articles tailored to the intended audience.
This skill is ideal for technical writers, content creators, and developers who need to produce comprehensive, practical, and multilingual technical documentation. It can be particularly useful for producing tutorials, technical guides, and API documentation with embedded runnable code examples. The ability to tailor content to the author's voice while maintaining a clear and informative structure makes this skill a powerful tool for content production in the technical field.
To get started, simply follow the workflow outlined in the Quick Start section. This includes determining the author, creating the necessary folder structure, loading the author profile, and setting up the article limits. Then, proceed through the phases of planning, research, drafting, creating the companion project, reviewing, condensing, translating, and finalizing.
The article-writer skill is specifically designed for technical articles. It focuses on research, detailed explanations, and companion projects, making it best suited for tutorials, documentation, and other technical content. It may not be ideal for non-technical articles.
One limitation is that the skill is designed to work with a structured workflow and is heavily reliant on the author's profile for tone and style consistency. It may not be suitable for content that requires a completely different voice or style. Additionally, the skill has article length limits that are controlled by the `article_limits.max_words` setting.
The skill does not specify exact programming languages for the companion projects. However, the companion project folder (`code/`) includes a `README.md` and code files which can support a variety of languages, allowing users to integrate any language they prefer.
The author profile plays a crucial role in shaping the tone and style of the article. It includes data such as formality, opinionated tone, vocabulary preferences, and sentence structure. This data ensures that the article reflects the author's unique voice, keeping the content consistent and true to the author's style.
Quick Setup:
.claude/skills/Repository
mwguerra/claude-code-plugins