Article Writing

SkillDocs & knowledge

Transform technical findings into clear, structured written content: penetration test reports, vulnerability disclosures, security blog posts, and technical documentation.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Article Writing skill

What this skill tells your AI

The instructions your AI receives, as published by brucesongs/kali-claw in skills/article-writing/SKILL.md and read by ahel’s review.

Summary

Article Writing skill domain covering knowledge operations.

Domain: knowledge

Skill Identity

AttributeValue
DomainDocumentation & Communication
Skill IDarticle-writing
Version1.0.0
Hacker LawsLaw 8 (Learn from Every Operation), Law 11 (Share Knowledge, Build Legacy)
Related Skillsknowledge-ops, deep-research

Purpose

Transform technical findings into clear, structured written content: penetration test reports, vulnerability disclosures, security blog posts, and technical documentation.

Writing is the final step in the intelligence workflow — turning raw findings into actionable deliverables for clients, researchers, or the public.

Article Types

TypeAudienceFormatLength
Pentest ReportClient (technical + executive)Executive Summary + Technical Findings10-50 pages
Vulnerability DisclosureVendor security teamCVE template + PoC2-5 pages
Security Blog PostPublic (technical)Narrative + code samples1000-3000 words
AdvisoryPublic (mixed audience)CVSS + mitigation steps500-1500 words
Technical DocumentationInternal teamHow-to guideVariable

Methodology

Phase 1: Gather Intelligence

# Aggregate all findings from knowledge-ops
grep -rn "type: finding" memory/*target*.md | wc -l

# Extract high-confidence findings (>= 75)
grep -rn "confidence: [789][0-9]\|confidence: 100" memory/*target*.md -l | \
  xargs grep -h "## Summary"

# Group by severity
grep -rn "tags:.*critical\|tags:.*high" memory/*target*.md

Phase 2: Structure Content

Follow the appropriate template (see below) for the article type. Outline before writing.

Phase 3: Write

  • Executive Summary: Non-technical, business impact-focused
  • Technical Detail: Reproducible, includes code/commands
  • Evidence: Screenshots, logs, PoC code
  • Recommendations: Actionable remediation steps

Phase 4: Review

  • Technical accuracy check
  • No sensitive data leakage (sanitize IPs, domains, credentials)
  • CVSS scoring (if applicable)
  • Proofread for clarity

Templates

Pentest Report Template

# Penetration Test Report: [Client Name]

**Date**: [date]
**Version**: [version]
**Prepared by**: [your org]
**Classification**: [Confidential/Restricted]

---

## Executive Summary

[Target]: [description of target scope]
[Duration]: [test dates]
[Findings Summary]: [count by severity]

### Key Findings

- **Critical**: [count] — [one-line impact]
- **High**: [count] — [one-line impact]
- **Medium**: [count] — [one-line impact]
- **Low**: [count] — [one-line impact]

### Business Impact

[2-3 sentences on overall risk to the organization]

### Recommendations Priority

1. [Most critical fix]
2. [Second priority]
3. [Third priority]

---

## Scope

**In Scope**:
- [systems/domains tested]

**Out of Scope**:
- [systems excluded]

**Testing Methodology**: [OWASP, PTES, custom]

---

## Findings

### Finding 1: [Vulnerability Name]

**Severity**: Critical
**CVSS**: 9.8 (CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H)
**Affected Systems**: [list]

##

## Description

[What is the vulnerability? How does it work?]

#### Evidence

```bash
[Commands used to discover/exploit]

[Screenshot or log output]

Impact
  • Confidentiality: [High/Medium/Low] — [why]
  • Integrity: [High/Medium/Low] — [why]
  • Availability: [High/Medium/Low] — [why]
Remediation

Short-term: [immediate fix] Long-term: [architectural improvement]

Verification: [how to verify fix]


[Continue for all findings]


Appendix

Tools Used

  • [tool list with versions]

Testing Timeline

DateActivity
[date]Reconnaissance
[date]Vulnerability scanning
[date]Manual testing
[date]Exploitation
[date]Reporting

References

  • [OWASP guides, CVE references, etc.]

### Vulnerability Disclosure Template

```markdown
# Vulnerability Disclosure: [Vulnerability Name]

**Date**: [discovery date]
**Severity**: [Critical/High/Medium/Low]
**CVSS**: [score] ([vector])
**CVE ID**: [if assigned, otherwise "Pending"]

---

## Affected Products

- **Product**: [name]
- **Versions**: [affected versions]
- **Fixed in**: [patched version, if known]

## Vulnerability Details

### Type

[SQL Injection / XSS / SSRF / etc.]

### Location

- **File**: [file path or URL]
- **Parameter**: [vulnerable parameter]
- **Method**: [GET/POST/etc.]

### Root Cause

[Technical explanation of why the vulnerability exists]

## Proof of Concept

```bash
[Minimal PoC to reproduce]

Expected Result: [what should happen] Actual Result: [what happens, demonstrating the vuln]

Impact

[Detailed impact analysis — what can an attacker achieve?]

Remediation

Developer Fix

[Code diff showing the fix, if simple]

Workaround (if patch not available)

[Temporary mitigation steps]

Timeline

DateEvent
[date]Vulnerability discovered
[date]Vendor notified
[date]Vendor acknowledged
[date]Patch released
[date]Public disclosure

Credits

[Your name/org]

Detection Methods

Content Authenticity Audit

  • AI-generated text detection: Statistical analysis (perplexity, burstiness) for AI fingerprints.
  • Plagiarism detection: Content matching against existing web corpus (Copyscape, Turnitin).
  • Style anomalies: Sudden style change in author's corpus; co-author compromise.

SIEM Detection Rules

  • Custom content analytics: Per-author baseline; alert on deviation.

Defense Evasion Techniques

AI Content Stealth

  • Humanize AI output: Use Wordtune, Quillbot to add human-like variance.
  • Mixed authorship: Combine AI-generated sections with human-written sections; reduces perplexity anomaly.
  • Style mimicry: Train model on target author's corpus; mimic their style.

References

  • [Related CVEs, vendor advisories, etc.]

### Security Blog Post Template

```markdown
# [Catchy Title]: [One-Sentence Hook]

**Published**: [date]
**Author**: [name]
**Tags**: [tag1, tag2, tag3]

---

## TL;DR

[2-3 sentences summarizing the entire post]

---

## Introduction

[Set the stage — why does this topic matter? What problem are you solving?]

## Background

[Context needed to understand the vulnerability/technique/tool]

## Discovery

[How did you find this? What were the initial signals?]

## Deep Dive

[Technical details — this is the meat of the post]

### Step 1: [Phase Name]

[Description]

```bash
[Commands]

[Output/screenshot]

Step 2: [Phase Name]

[Continue for all steps]

Impact & Exploitation

[What can an attacker do with this? Real-world scenarios]

Detection & Mitigation

For Defenders

  • [Detection method 1]
  • [Detection method 2]

For Developers

  • [Secure coding practice to prevent this]

Conclusion

[Wrap up — key takeaways, call to action]

References

  • [Links to related research, tools, CVEs]

## Use Cases

1. **Pentest Deliverable**: Final report for client after engagement
2. **Responsible Disclosure**: Notify vendor of discovered vulnerability
3. **Knowledge Sharing**: Publish research findings publicly
4. **Internal Documentation**: Record methodology for team playbooks
5. **Advisory Publishing**: Warn community of active threat

## Writing Best Practices

- **Be precise**: Use exact file paths, line numbers, version numbers
- **Be reproducible**: Include all commands, payloads, and environment details
- **Be cautious**: Sanitize sensitive data (IPs, domains, real credentials)
- **Be visual**: Screenshots, diagrams, code blocks
- **Be actionable**: Every finding needs a clear fix

## Integration

- **Input**: knowledge-ops findings, test-cases validation results
- **Output**: Markdown/PDF reports, blog posts, advisories
- **Handoff**: Share with client, vendor, or publish publicly

Signals

GitHub stars
71
Forks
18
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
article-writing-brucesongs
Source
github.com/brucesongs/kali-claw