Dockerignore Linter
/install dockerignore-linter
Dockerignore Linter
Lint .dockerignore files for syntax issues, security risks, missing essential patterns, and optimization opportunities.
Commands
All commands use the bundled Python script at scripts/dockerignore_linter.py.
1. Lint a .dockerignore file
python3 scripts/dockerignore_linter.py lint \x3Cfile> [--strict] [--format text|json|markdown]
Run all validation rules.
2. Audit for security-sensitive files
python3 scripts/dockerignore_linter.py security \x3Cfile> [--format text|json|markdown]
Check if secrets, credentials, and sensitive files are properly excluded.
3. Suggest missing patterns
python3 scripts/dockerignore_linter.py suggest [--project-type node|python|go|rust|java|ruby|generic] [--format text|json]
Generate recommended .dockerignore patterns for a project type.
4. Analyze Docker build context
python3 scripts/dockerignore_linter.py context \x3Cdirectory> [--dockerignore \x3Cfile>] [--format text|json]
Show which files would be included in the Docker build context, with size breakdown.
Lint Rules (18 total)
Syntax (4 rules)
- empty-file — .dockerignore is empty
- invalid-pattern — Malformed glob pattern
- duplicate-pattern — Same pattern appears twice
- negation-conflict — Negation
!overrides a previous exclusion (likely unintended)
Security (6 rules)
- missing-env —
.envnot excluded (may contain secrets) - missing-secrets — Common secret files not excluded (*.pem, *.key, id_rsa, etc.)
- missing-git —
.gitdirectory not excluded (exposes history + credentials) - missing-credentials — Credential files not excluded (aws/credentials, .npmrc with tokens, etc.)
- missing-docker — Docker-related files not excluded (docker-compose*.yml, Dockerfile*)
- missing-ide — IDE config not excluded (.vscode, .idea, *.swp)
Optimization (4 rules)
- missing-deps — Dependency directories not excluded (node_modules, pycache, vendor, target)
- missing-build — Build output not excluded (dist, build, *.o, *.pyc)
- missing-logs — Log files not excluded (*.log, logs/)
- missing-test — Test data/coverage not excluded (coverage, .nyc_output, htmlcov)
Best Practices (4 rules)
- too-broad — Pattern is overly broad (e.g.,
*without specific negations) - commented-pattern — Inline comment after pattern (not supported, treated as literal)
- trailing-space — Pattern has trailing whitespace
- readme-excluded — README/docs excluded (usually should be kept for reference)
Output Formats
Text, JSON, Markdown — same structure as other linters.
CI Integration
- name: Lint Dockerignore
run: python3 scripts/dockerignore_linter.py lint .dockerignore --strict
Exit codes: 0 = clean, 1 = issues found.
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install dockerignore-linter - 安装完成后,直接呼叫该 Skill 的名称或使用
/dockerignore-linter触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Dockerignore Linter 是什么?
Lint, validate, and audit .dockerignore files for syntax issues, security risks, missing patterns, and optimization opportunities. Use when asked to lint, va... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 94 次。
如何安装 Dockerignore Linter?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install dockerignore-linter」即可一键安装,无需额外配置。
Dockerignore Linter 是免费的吗?
是的,Dockerignore Linter 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Dockerignore Linter 支持哪些平台?
Dockerignore Linter 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Dockerignore Linter?
由 charlie-morrison(@charlie-morrison)开发并维护,当前版本 v1.0.0。