🐚
WritingPython

Bash Style

by doccker

Bash Style is a Writing skill for Claude Code, published by doccker in cc-use-exp.

1K stars105 forkson doccker/cc-use-expAdded 2026/08/21Repository updated 2026/06/30
antigravityclaude-codecodexcursorgemini-cligithub-copilot
Install in seconds
Install Bash Style
Copy Bash Style into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/doccker/cc-use-exp/tree/main/skills/bash-style ~/.claude/skills/bash-style

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/doccker/cc-use-exp.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/bash-style/SKILL.md in doccker/cc-use-exp
Installs to
~/.claude/skills/bash-style
Collection
One of 23 skills cataloged from this repository
Category
Writing1012 skills

What Bash Style does

Bash Style provides shell scripting and command-writing conventions for .sh files, Dockerfiles, Makefiles, YAML, and Markdown bash blocks. Use it to format commands, heredocs, file writes, permissions, and script safety.

Bash Style is cataloged under Writing on DirSkills. Bash Style comes from a repository tagged antigravity, claude-code, codex, cursor and gemini-cli.

Documentation

README

Bash 编写规范

版本:v1.0 更新:2026-01


1. 注释规范

禁止行尾注释

  • 禁止行尾注释(如 command # 注释
  • ✅ 注释应独占一行,放在代码上方

适用范围

  • Shell 脚本文件(.sh)
  • Markdown 文档中的 bash 代码块
  • Dockerfile、Makefile 中的 shell 命令
# ❌ 错误:行尾注释
curl -X POST https://api.example.com/data # 发送请求
docker run -d nginx # 启动容器
cp -r src/ dist/ # 复制文件

# ✅ 正确:注释独占一行
# 发送请求
curl -X POST https://api.example.com/data

# 启动容器
docker run -d nginx

# 复制文件
cp -r src/ dist/

原因

  • 复制粘贴时容易带上注释导致命令出错
  • 长命令 + 注释 = 超长行,可读性差
  • Heredoc 块内 # 不是注释而是内容

2. 文件写入方式

推荐方式:tee 命令

# ✅ 推荐:简洁、无嵌套引号
sudo tee /etc/fail2ban/jail.d/docker-nginx.local > /dev/null << 'EOF'
[docker-nginx]
enabled = true
filter = docker-nginx
logpath = /var/log/nginx/access.log
maxretry = 5
EOF

追加内容

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Bash Style

  • What else does doccker publish alongside Bash Style?

    Bash Style is one of 23 skills that DirSkills catalogs from doccker/cc-use-exp, the repository it ships in. Its siblings there include API Design Safety, Api Design Safety and Api Proxy Safety. Each one is a separate skill with its own page in this directory, installs the same way Bash Style does, and is maintained by doccker in that same repository. The rest of the collection is listed on the doccker/cc-use-exp page.

  • How does Bash Style compare to other Writing skills?

    Bash Style ranks #443 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Bash Style against them. Open each page to compare what they document and how they install.

More from doccker/cc-use-exp

Bash Style is one of 23 skills cataloged on DirSkills from doccker/cc-use-exp.

See all 23 skills
🛡️
1w ago

API Design Safety

API Design Safety helps you design REST API responses and generated outputs with consistent field semantics, null handling, and status codes. It also checks required fields before exporting files or sending downstream payloads to avoid silent failures.
Quality
1K105
🧩
1w ago

Api Design Safety

Api Design Safety helps prevent REST API response design mistakes such as field mix-ups, ambiguous return types, and inconsistent empty values. Use it when designing or changing API responses and handling returned data.
AI Engineering
1K105
🛡️
1w ago

Api Proxy Safety

Api Proxy Safety defines safe keyword matching for gateways, proxies, WAFs, and CDNs so normal content is not misclassified as an error. It is used when implementing heuristic checks for response bodies, status codes, and error schemas.
DevOps
1K105
1w ago

Async Task Pattern

Async Task Pattern provides a standard triggerAsync/getStatus flow for operations that may run longer than 10 seconds. Use it for batch processing, remote API fan-out, or scans that would otherwise time out or be triggered twice.
Automation
1K105
🧩
1w ago

Code Quality Principles

Code Quality Principles provides a checklist for modular design, refactoring, and code review. Use it to assess module size, call depth, fan-in/fan-out, boundaries, scope cohesion, and predictability.
Quality
1K105
🧪
1w ago

External System Debugging

External System Debugging helps debug code that depends on browsers, editors, CDNs/WAFs, IM platforms, clipboards, or third-party SaaS. It requires collecting real environment data first, then using that evidence to diagnose paste, rendering, API, and cross-platform issues.
Quality
1K105