| type | Skill |
| name | document-in-case |
| description | Add a comment to a case to document findings, actions, or recommendations. Use to maintain audit trail during investigations. Requires CASE_ID and comment text. |
| required_roles | {"soar":"roles/chronicle.editor"} |
| personas | ["tier1-analyst","tier2-analyst","tier3-analyst","threat-hunter","incident-responder"] |
| generated | {"by":"human:dandye","at":"2026-02-04T11:10:49.000Z"} |
Document in Case Skill
Add a standardized comment to a case to document findings, actions taken, or recommendations.
Inputs
CASE_ID - The SOAR case ID to add the comment toCOMMENT_TEXT - The full text of the comment to be added- (Optional)
ALERT_GROUP_IDENTIFIERS - Alert group identifiers if required
Workflow
Step 1: Post Comment
secops-soar.post_case_comment(
case_id=CASE_ID,
comment=COMMENT_TEXT,
alert_group_identifiers=ALERT_GROUP_IDENTIFIERS // if provided
)
Step 2: Verify Status
Check the API response to confirm the comment was posted successfully.
Outputs
| Output | Description |
|---|
COMMENT_POST_STATUS | Success/failure status of the comment posting |
Comment Templates
Enrichment Summary:
IOC Enrichment for [IOC_VALUE] ([IOC_TYPE]):
- GTI Reputation: [score/classification]
- SIEM Activity: [first/last seen, alert count]
- IOC Match: [Yes/No]
- Assessment: [Low/Medium/High risk]
- Recommendation: [next steps]
Triage Decision:
Alert Triage Complete:
- Classification: [FP/BTP/TP/Suspicious]
- Key Findings: [summary]
- Rationale: [why this classification]
- Action Taken: [closed/escalated]
Investigation Update:
Investigation Update [timestamp]:
- Actions Completed: [list]
- Findings: [summary]
- Next Steps: [planned actions]
