CtrlK
BlogDocsLog inGet started
Tessl Logo

generate-report

Save investigation findings to a markdown report file. Use after completing triage, enrichment, or investigation to create a permanent record. Generates timestamped files in ./reports/ directory.

Install with Tessl CLI

npx tessl i github:dandye/ai-runbooks --skill generate-report
What are skills?

81

Does it follow best practices?

Validation for skill structure

SKILL.md
Review
Evals

Generate Report Skill

Save generated report content to a markdown file with standardized naming convention.

Inputs

  • REPORT_CONTENT - The full markdown content of the report
  • REPORT_TYPE - Short identifier for the report type:
    • alert_triage - Alert triage reports
    • ioc_enrichment - IOC enrichment reports
    • case_investigation - Case investigation reports
    • hunt_summary - Threat hunt reports
    • incident_report - Incident response reports
  • REPORT_NAME_SUFFIX - Descriptive suffix (e.g., case ID, IOC value, hunt name)
  • (Optional) TARGET_DIRECTORY - Directory to save in (default: ./reports/)

Workflow

Step 1: Construct Filename

Generate standardized filename:

{TARGET_DIRECTORY}/{REPORT_TYPE}_{REPORT_NAME_SUFFIX}_{YYYYMMDD_HHMM}.md

Examples:

  • ./reports/alert_triage_case_1234_20250115_1430.md
  • ./reports/ioc_enrichment_198.51.100.10_20250115_0900.md
  • ./reports/hunt_summary_APT29_20250115_1200.md

Step 2: Write File

Use the Write tool to save REPORT_CONTENT to the constructed path.

Outputs

OutputDescription
REPORT_FILE_PATHFull path to the saved report file
WRITE_STATUSSuccess/failure status of the write operation

Report Template Structure

# [Report Type]: [Subject]

**Generated:** [timestamp]
**Runbook:** [runbook name that generated this]
**Case/Alert ID:** [if applicable]

## Summary
[Brief overview of findings]

## Details
[Detailed findings, enrichment data, etc.]

## Assessment
[Risk assessment, classification]

## Recommendations
[Next steps, actions to take]

## Appendix
[Raw data, tool outputs, diagrams]

Naming Convention

Report TypeSuffix ExampleFull Example
alert_triagecase_1234alert_triage_case_1234_20250115_1430.md
ioc_enrichmentevil.comioc_enrichment_evil.com_20250115_0900.md
hunt_summaryAPT29hunt_summary_APT29_20250115_1200.md
Repository
dandye/ai-runbooks
Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.