About security-audit
security-audit is a skill for reviewing application code, dependencies, configuration, architecture, and API security. It guides reviewers through scoping, severity classification, remediation, and reporting, while noting that it does not replace penetration testing.
Key features
- 01Reviews code against common vulnerabilities
- 02Checks dependencies for CVEs and outdated packages
- 03Audits configuration, architecture, and API security
- 04Classifies findings by severity
- 05Guides remediation and audit reporting
Use cases
- 01Reviewing a feature or pull request for security issues
- 02Checking dependencies before deployment
- 03Assessing secrets and permissions after infrastructure changes
- 04Evaluating API security for new endpoints
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ srstomp/ pokayokay --skill security-auditAfter installing, type/security-auditin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/api-security.mdauth-patterns.mddependency-security.mdowasp-top-10.mdsecrets-management.mdDetails
From the project READMESecurity Audit
Systematic security review for application code, dependencies, and configuration.
Not a replacement for professional penetration testing. Identifies common vulnerabilities within scope of code review.
Audit Types
| Type | Focus | When to Use |
|---|---|---|
| Code Review | OWASP Top 10, injection, auth | New features, PRs, suspicious code |
| Dependency | CVEs, outdated packages | Before deploy, periodic, CI/CD |
| Configuration | Secrets, permissions, hardening | Infrastructure changes, new envs |
| Architecture | Attack surface, data flow | Design phase, major refactors |
| API Security | Auth, authz, rate limiting | New endpoints, public APIs |
When NOT to Use
- Designing new auth flows — Use
api-designfor designing OAuth2/JWT endpoints from scratch - Performance issues — Use
observabilityto diagnose latency and resource problems, even if caused by auth overhead - CI/CD pipeline security — Use
ci-cdfor pipeline hardening (secret management, permissions)
Key Principles
- Scope first — Define audit area, depth, and constraints before scanning
- Classify severity — Critical (24-48h), High (1 week), Medium (2-4 weeks), Low (backlog)
- Remediate or track — Fix critical issues immediately, create ohno tasks for the rest
- No secrets in code — Scan for hardcoded credentials, API keys, connection strings
Quick Start Checklist
- Define audit scope and type (code, dependency, config, architecture, API)
- Run automated scans (npm audit, grep patterns, secret detection)
- Review findings and classify severity using decision tree in references
- Remediate critical/high findings immediately
- Create ohno tasks for medium/low findings with appropriate priority
- Document findings in audit report
References
| Reference | Description |
|---|---|
| owasp-top-10.md | OWASP vulnerabilities with detection and fixes |
| dependency-security.md | npm audit, pip-audit, Snyk, CI/CD integration |
| auth-patterns.md | Secure authentication and authorization patterns |
| api-security.md | API-specific security concerns |
| secrets-management.md | Handling sensitive configuration |
Runtime Notes
- Claude Code: dispatch yokay-security-scanner via the Task tool with
subagent_type: "pokayokay:yokay-security-scanner". - Codex: there is no subagent dispatch. Execute the agent's role inline — read the corresponding
agents/yokay-<name>.mdand follow its Behavioral Defaults, Critical Rules, and Output Contract directly in the current session.
Comments
Markdown supported