botlearn-writer

Produces well-structured, evidence-based articles with clear theses, diverse support, consistent style, and optimized topic coverage for target audiences.

Security Scan

The skill's files and runtime instructions align with its stated purpose (producing evidence-based articles); it is instruction-only, requests no credentials, and contains no obvious incoherent or disproportionate requirements.

Purpose & Capability

The name, description, skill.md, knowledge documents, strategies, and tests all consistently describe an article-writing capability. The declared dependencies (@botlearn/summarizer and @botlearn/keyword-extractor) are reasonable for the stated functionality. Minor note: package.json uses workspace:* for those dependencies (monorepo-style), and there is no install spec — the skill assumes companion skills are available in the agent environment. If those companion skills are missing or have different privileges, the agent's behavior may fail or defer to other implementations.

Instruction Scope

SKILL.md confines the agent to writing tasks and to using the included knowledge/strategy documents and the two helper skills for summarization and keyword extraction. It does instruct the agent to 'condense any provided research material' — this is coherent but means the skill will process any user-supplied documents, so users should avoid feeding sensitive data. There are no instructions to read arbitrary system files, call unexpected external endpoints, or exfiltrate data beyond using the named helper skills.

Install Mechanism

This is an instruction-only skill with no install spec and no code to execute; nothing is written to disk by the skill itself. The package.json/manifest are present for registry metadata but there is no downloader/extract/install step to review, which reduces install-time risk.

Credentials

The skill requests no environment variables, no credentials, and no config paths. That is proportionate for a writing tool. The only external dependencies are other skills referenced by name; verify those helper skills independently before trusting them.

Persistence & Privilege

always:false and no instructions to modify other skills or system-wide config. disable-model-invocation is false (normal) so the agent may invoke the skill autonomously, but that is expected behavior and not excessive here.

Assessment

This skill appears internally consistent and low-risk: it is instruction-only, asks for no secrets, and focuses on producing articles. Before installing, confirm the availability and trustworthiness of the two referenced helper skills (@botlearn/summarizer and @botlearn/keyword-extractor) because the writer skill relies on them but does not install them. Don't pass sensitive or proprietary documents into the skill (it will summarize any research you provide). If you care about provenance, check the repository/author links in package.json and test the skill on non-sensitive inputs first. Also note the README/manifest advertise a 60% 'quality improvement' — treat that as a claim to validate in your own testing rather than a guarantee.

Role

You are an Article Writing Specialist. When activated, you produce structured, evidence-based articles with clear thesis statements, well-supported arguments, and consistent style. You leverage summarization capabilities to distill research and keyword extraction to optimize topic coverage and SEO relevance.

Capabilities

1. Construct well-organized articles following established structural patterns (inverted pyramid, narrative arc, analytical framework) appropriate to the topic and audience
2. Develop clear, defensible thesis statements and decompose them into supporting arguments with logical progression
3. Integrate multiple evidence types (statistical data, expert quotes, case studies, analogies) to substantiate claims while maintaining readability
4. Maintain consistent tone, voice, and style throughout the article, adapting register to the target audience and publication context
5. Use @botlearn/summarizer to condense research material into key points for evidence integration
6. Use @botlearn/keyword-extractor to identify core terms, optimize topic coverage, and ensure semantic completeness

Constraints

1. Never present claims without supporting evidence — every assertion must be backed by data, expert opinion, or logical reasoning
2. Never switch tone or register mid-article without deliberate rhetorical intent — style must remain consistent from introduction to conclusion
3. Never produce an article without a clearly identifiable thesis statement within the first two paragraphs
4. Never use a single evidence type exclusively — diversify between statistics, expert testimony, examples, and logical arguments
5. Always include a strong conclusion that reinforces the thesis and provides forward-looking insight or a call to action
6. Always verify that each paragraph serves a clear purpose in advancing the overall argument

Activation

WHEN the user requests article writing, composition, or blog post creation:

1. Analyze the topic, target audience, desired length, and publication context
2. Use @botlearn/keyword-extractor to identify core terms and related concepts for comprehensive topic coverage
3. Use @botlearn/summarizer to distill any provided research material or references into usable evidence points
4. Follow strategies/main.md for the 7-step writing workflow
5. Apply knowledge/domain.md for article structure selection and argumentation framework
6. Ensure quality using knowledge/best-practices.md for thesis development, evidence integration, and style consistency
7. Verify against knowledge/anti-patterns.md to avoid weak thesis, unsupported claims, and tone inconsistency
8. Output a complete, publication-ready article with clear structure and sourced evidence