Claude Code, Plugin
Claude Code Best Practices
A comprehensive guide to using Claude Code effectively in your projects, demonstrated through a working expense tracker application.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV PERMISSION_SHELL_DECLARED OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
templates/dashboard.html, line 120
const res = await fetch('/expenses'); - SECRETS_PATH_DOTENV Low
Mentions a .env file.
.claude/commands/git-commit.md, line 18
looks like a secret (`.env`, `*.pem`, `*.key`, `credentials*`, an obvious API key in a - PERMISSION_SHELL_DECLARED Note
Runs shell commands, and the manifest or description says so.
.claude/hooks/check-black-formatting.py, line 34
check_result = subprocess.run( - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
uv.lock, line 1
version = 1
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Note
requests shell access. The manifest names this permission.
PERMISSION_SHELL_DECLARED
.claude/hooks/check-black-formatting.py, line 34
check_result = subprocess.run(
.claude/hooks/check-black-formatting.py, line 42
subprocess.run(["uv", "run", "black", "--quiet", file_path])
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
templates/dashboard.html, line 120
const res = await fetch('/expenses');
templates/dashboard.html, line 178
const res = await fetch('/summary');
templates/dashboard.html, line 204
await fetch('/expenses', {
Show more
templates/dashboard.html, line 216
await fetch(`/expenses/${id}`, { method: 'DELETE' });
Secrets
Concern
reads a credential or environment file.
SECRETS_PATH_DOTENV
.claude/commands/git-commit.md, line 18
looks like a secret (`.env`, `*.pem`, `*.key`, `credentials*`, an obvious API key in a
.claude/rules/security.md, line 76
- `.gitignore` already excludes `*.db`, `.env`/`.env.*`, and common secret-bearing paths.
.claude/rules/security.md, line 77
Never commit the SQLite file or a real secret key; if this project ever needs a `.env`,
Show more
.claude/settings.json, line 20
"command": "python3 -c \"\nimport sys, json\ndata = json.load(sys.stdin)\ncmd = data.get('tool_input', {}).get('command', '')\nprotected = ['spendly.db', '.env', 'migrations/']\nda
.gitignore, line 15
# Env / secrets
.gitignore, line 16
.env
README.md, line 47
(`__pycache__/`, `node_modules/`, `.venv/`), build output, secrets (`.env`, `.env.*`,
README.md, line 57
.env
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Note
a file was over the read cap and was not fully read.
OBFUSCATION_FILE_OVER_READ_CAP
uv.lock, line 1
version = 1
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 9a67872639cf. requests shell access. The manifest names this permission. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.
Date and source
Date checked:
github.com
Commit graded: 9a67872639cff25d83219d4d0b84a0122c8b106b
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.