Agent Skill
2/7/2026

skill-reviewer

Reviews skills against Claude Code best practices. Use when auditing skill files for adherence to recommendations.

I
igbuend
3GitHub Stars
2Views
npx skills add igbuend/grimbard

SKILL.md

Nameskill-reviewer
DescriptionReviews skills against Claude Code best practices. Use when auditing skill files for adherence to recommendations.
<p align="center" width="100%"> <img width="50%" src="grimbard.png" alt="grimbard logo" title="grimbard logo"> </p>

grimbard

License: MIT pre-commit

87 skills for AI agents — anti-patterns, security patterns, static analysis tools, and code review workflows for Claude Code, Cursor, Windsurf, Gemini CLI, and 30+ other agents.

Built by a pentester and secure code reviewer. Battle-tested in real engagements.

Quick Start

npx skills add igbuend/grimbard

That's it. Your AI agent now has 79 skills covering:

  • 38 security anti-patterns — detect vulnerable code (XSS, SQLi, command injection, etc.)
  • 21 security patterns — implement secure designs (authentication, encryption, etc.)
  • 11 static analysis tool skills — run and interpret SAST tools
  • 4 review & discovery skills — SARIF triage, attack surface mapping, codebase discovery
  • 3 quality assurance skills — review agents, skills, and sub-agents
  • 1 ethics skill — responsible disclosure and legal frameworks

Try it

After installing, ask your AI agent:

Review this folder for security vulnerabilities

The agent automatically loads the relevant anti-pattern skills based on the code context — XSS patterns for HTML rendering, SQLi patterns for database queries, etc.

What's Included

Security Anti-Patterns (38 skills)

Each skill provides BAD (vulnerable) and GOOD (secure) code examples to help AI agents identify and fix security vulnerabilities.

SkillCWEDescription
command-injection-anti-patternCWE-78Shell command string concatenation
sql-injection-anti-patternCWE-89SQL query string building
xss-anti-patternCWE-79Cross-site scripting (reflected, stored, DOM)
path-traversal-anti-patternCWE-22Directory traversal via user input
hardcoded-secrets-anti-patternCWE-798Credentials in source code
missing-authentication-anti-patternCWE-306Unprotected endpoints
missing-input-validation-anti-patternCWE-20Unvalidated user input
jwt-misuse-anti-patternCWE-347JWT implementation flaws
open-cors-anti-patternCWE-942Overly permissive CORS
mass-assignment-anti-patternCWE-915Unfiltered object binding
dom-clobbering-anti-patternCWE-79HTML injection overwrites JS globals
encoding-bypass-anti-patternCWE-838Validation before normalization
mutation-xss-anti-patternCWE-79Sanitizer bypass via parser mutations
missing-security-headers-anti-patternCWE-16Missing CSP, HSTS, X-Frame-Options
session-fixation-anti-patternCWE-384Session ID not rotated after login
insecure-defaults-anti-patternCWE-276Unsafe default configurations
weak-encryption-anti-patternCWE-327Broken or weak crypto algorithms
weak-password-hashing-anti-patternCWE-916MD5/SHA1 for passwords
unrestricted-file-upload-anti-patternCWE-434Dangerous file upload handling
verbose-error-messages-anti-patternCWE-209Stack traces in production
log-injection-anti-patternCWE-117Unsanitized data in log entries
debug-mode-production-anti-patternCWE-489Debug features in production
excessive-data-exposure-anti-patternCWE-200Over-sharing in API responses
missing-rate-limiting-anti-patternCWE-770No throttling on sensitive endpoints
hallucinated-packages-anti-patternCWE-829AI-invented dependency names
oauth-security-anti-patternCWE-346OAuth/OIDC implementation flaws
redos-anti-patternCWE-1333Catastrophic regex backtracking
timing-attacks-anti-patternCWE-208Non-constant-time comparisons
integer-overflow-anti-patternCWE-190Arithmetic overflow/underflow
type-confusion-anti-patternCWE-843Type mismatch vulnerabilities
unicode-security-anti-patternCWE-176Unicode normalization attacks
ldap-injection-anti-patternCWE-90LDAP query injection
xpath-injection-anti-patternCWE-643XPath query injection
second-order-injection-anti-patternCWE-74Stored data used unsafely later
padding-oracle-anti-patternCWE-649Padding oracle cryptographic attacks
length-extension-attacks-anti-patternCWE-328Hash length extension
insecure-temp-files-anti-patternCWE-377Predictable temp file paths
insufficient-randomness-anti-patternCWE-330Weak random number generation

Security Patterns (21 skills)

Secure design patterns from DistriNet Research. Each pattern explains when to use it, how to implement it, and what to watch out for.

CategoryPatterns
AuthenticationPassword-based, Opaque token, Verifiable token (JWT), Session-based access control
CryptographyEncryption, Digital signature, MAC, Key management, Crypto-as-a-service, Self-managed crypto, Cryptographic action
Data ProtectionSelective encrypted storage, Selective encrypted transmission, Transparent encrypted storage, Encrypted tunnel
Access ControlAuthorisation, Session-based access control
Input/OutputData validation, Output filter
OperationsLimit request rate, Log entity actions

Static Analysis Tools (11 skills)

Skills that teach AI agents how to run and interpret results from security tools. Each skill includes installation instructions — ask your AI agent to install a tool and it will guide you through it.

ToolPurpose
OpengrepPattern-based SAST (open-source Semgrep fork)
SemgrepPattern-based SAST
GitleaksSecrets and credential detection
KICSInfrastructure-as-Code security
NoirAPI endpoint and attack surface discovery
OSV-ScannerDependency vulnerability scanning
DepscanAdvanced SCA with SBOM/VDR
Application InspectorTechnology profiling
CodeQLDeep cross-file static analysis
TrivyContainer and dependency scanning
SARIF ToolsProcess, merge, diff, and report on SARIF files

Other Skills

SkillDescription
SARIF Issue ReporterTriage and report SARIF findings from any tool
Attack Surface XSSXSS-focused attack surface analysis
Codebase DiscoveryRepository structure and technology mapping
Content Security PolicyCSP header analysis and bypass detection
Ethical Hacking EthicsLegal frameworks, responsible disclosure, platform rules
Skill ReviewerReview quality of other skills
Agent ReviewReview agent configurations
Sub-Agent ReviewReview sub-agent setups

Full Agent (Optional)

For the complete security review workflow with automated tool orchestration, clone the repo and use it with Claude Code:

git clone https://github.com/igbuend/grimbard.git
cd grimbard

The agent provides structured workflows:

  • /grimbard-review — Full 6-phase security review (4-8 hours)
  • /grimbard-quick — Quick automated scan (15-30 min)
  • /grimbard-triage — Prioritize existing SARIF findings
  • /grimbard-compliance — PCI-DSS, HIPAA, SOC2, GDPR audit

See agents/grimbard/AGENT.md for full documentation.

Example Review

See a complete grimbard-style security review of OWASP Juice Shop — 14 findings across P0–P3, each mapped to the grimbard skill that detects it.

DevContainer

A DevContainer is included with all security tools pre-installed — no manual setup needed. Open the repo in VS Code with the Remote Containers extension, or use GitHub Codespaces.

FAQ

Why the name grimbard?

Grimbard is the badger in the medieval fable of Reynard the Fox — a loyal supporter, defender and advisor of the cunning fox. Grimbard represents wisdom, counsel and trustworthy guidance. Perfect for a repository of security patterns and knowledge.

Grimbard also gives the advice to the wrong person. Whether that's you or the AI is for you to decide.

How do skills work?

When you ask your AI agent a security-related question, it:

  1. Identifies the relevant pattern(s) based on your question
  2. Loads the pattern knowledge from the SKILL.md file
  3. Applies the pattern to your specific context
  4. Provides implementation guidance tailored to your codebase

Should I install all skills?

Yes — they're lightweight (just markdown). The AI only loads relevant skills when needed. Having all of them available means the AI can catch more issues across your codebase.

Do these help with compliance?

Yes. The patterns cover requirements from PCI-DSS, HIPAA, GDPR, and SOC 2. However, compliance requires more than technical controls — consult compliance experts.

I found a mistake / want to improve something

Please open a GitHub issue or submit a pull request.

Roadmap

  • v1.0 — All skills fully tested and validated
  • v2.0 — AI agent with orchestrated tool execution
  • v3.0 — The AIs will decide by then

ko-fi

Licensing

The code in this project is licensed under the MIT license.

The documents (e.g. markdown files) in this project are licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

The security pattern skills were created from Security Pattern Catalogue - DistriNet Research. The Gitlab repo is licensed under a Creative Commons Attribution Non Commercial Share Alike 4.0 International License.

The anti-pattern skills were created from sec-context by Arcanum Security. The repository does not contain any copyright information (which legally means it is copyrighted by default). Awaiting clarification, but consider this work a derivative (IANAL).

Some skills are modified versions from the Trail of Bits Skills Marketplace, licensed under CC BY-SA 4.0.

Skills Info
Original Name:skill-reviewerAuthor:igbuend