CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audit-report

Generate audit reports and compliance trails using Harness audit trail data via MCP v2 tools. Track user actions, resource changes, authentication events, and access patterns across accounts, organizations, and projects. Use when asked to audit activity, generate compliance reports, investigate security incidents, review user actions, check change logs, or produce SOC2/GDPR/HIPAA audit evidence. Trigger phrases: audit report, audit trail, compliance audit, user activity log, change log, access audit, security investigation, who changed what, audit events.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured operational guide: concrete MCP v2 tool calls, a clear six-step workflow, and proper offloading of report templates and compliance mappings to a real one-level reference. The main weaknesses are a fully duplicated error-handling/troubleshooting section, tautological enum tables, and unspecified filter parameters in Steps 3–4.

Suggestions

Merge the Error Handling table and the Troubleshooting section into a single location — both cover the same four failure modes (no events, access denied, incomplete pagination, search-term mismatch) in slightly different forms.

In Steps 3 and 4, show the concrete filter parameters for action and resource type (or explicitly state that Step 1's harness_describe call reveals them) instead of only listing the enum values.

Embed validation checkpoints directly in the workflow steps — e.g., after Step 2: "Confirm all pages are fetched (`size` returned equals `size` requested) before proceeding to analysis" — rather than deferring them to separate sections.

Trim tautological table descriptions such as "CREATE | Resource creation" and "DELETE | Resource deletion", keeping only rows that add non-obvious domain knowledge.

DimensionReasoningScore

Conciseness

The body avoids explaining known concepts and is mostly operational detail, but the Error Handling table ("No audit events returned... Broaden time range; verify org_id/project_id") and the Troubleshooting section ("No Events Found: 1. Start with a broader time range... 2. Verify the org_id and project_id scope") repeat the same four failure modes, and rows like "`CREATE` | Resource creation" restate the obvious. Fits anchor 3 (could be tightened); not 4 because a whole duplicated section is more than minor trimming; not 2 because the bulk is domain-specific Harness knowledge, not padding.

3 / 5

Actionability

Concrete, parameterized tool calls ("harness_list(resource_type=\"audit_event\", org_id=\"<org>\", project_id=\"<project>\", search_term=\"<user or resource>\", page=0, size=100)") plus five realistic example prompts make the guidance mostly executable. Not 5: Steps 3 and 4 ("Filter by Action Type", "Filter by Resource Type") enumerate enum values without showing the actual filter parameter used to apply them — the mechanism is left implicit.

4 / 5

Workflow Clarity

Six clearly sequenced steps (discover filters → list → filter by action → filter by resource → analyze → report) with validation guidance present ("verify every claim against actual audit data", "check if `size` returned equals the `size` requested") and error-recovery procedures. Not 5: checkpoints live in separate Error Handling/Performance Notes/Troubleshooting sections rather than embedded in the step sequence itself; not 3: pagination and data-verification checks are explicit, and the skill is read-only so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

A single well-signaled, one-level-deep reference — "For report templates (General, User Activity, Security) and compliance framework mappings (SOC 2, GDPR, HIPAA), consult references/report-templates.md" — matches the actual bundle (the file exists and contains exactly those templates and mappings), and the bulky template content is appropriately split out of SKILL.md. Not 4: navigation is clear and there is no content that should have been inlined or moved.

5 / 5

Total

16

/

20

Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: concrete third-person actions, an explicit 'Use when' clause, and a dedicated trigger-phrase list that includes natural synonyms. The only nit is mild redundancy between the 'Use when asked to...' sentence and the 'Trigger phrases:' list, which is informative rather than padded.

DimensionReasoningScore

Specificity

"Generate audit reports and compliance trails using Harness audit trail data" plus "Track user actions, resource changes, authentication events, and access patterns across accounts, organizations, and projects" lists multiple specific concrete actions with comprehensive coverage of the audit-reporting domain. Not 4: coverage spans generation, tracking, investigation, and evidence production with no notable gaps.

5 / 5

Completeness

"Generate audit reports and compliance trails... Track user actions, resource changes, authentication events" clearly answers what, and "Use when asked to audit activity, generate compliance reports, investigate security incidents, review user actions, check change logs, or produce SOC2/GDPR/HIPAA audit evidence" explicitly answers when with concrete triggers. Exactly matches the anchor-5 pattern; not 4 because the 'when' is fully enumerated rather than merely adequate.

5 / 5

Trigger Term Quality

The explicit list "Trigger phrases: audit report, audit trail, compliance audit, user activity log, change log, access audit, security investigation, who changed what, audit events" covers natural phrasings users would actually say, including synonyms ("user activity log" vs "change log") and the colloquial "who changed what". Not 4: no common natural variation for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Scoping to "Harness audit trail data via MCP v2 tools" with distinct triggers like "audit trail", "compliance audit", and "SOC2/GDPR/HIPAA audit evidence" establishes a clear niche with minimal overlap risk. Not 4: the domain scoping and audit-specific trigger list make it unlikely to fire for unrelated skills.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

harness/harness-ai

Path

plugins/claude/skills/audit-report/SKILL.md

Reviewed

Table of Contents

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.