Przejdź do treści
Biblioteka skilli
AI i agenci · Nauka i wyjaśnianie

bash-tools

/bash-tools

Uczy właściwego użycia narzędzi Bash, Write, Edit i Read do poleceń powłoki i zapisu plików, bez obchodzenia uprawnień przez echo, cat czy heredoc.

Repozytorium
DraftForge ↗
Licencja
GPL-3.0
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

GPL-3.0, otwarta.

Co robi i kiedy

Uczy właściwego użycia narzędzi Bash, Write, Edit i Read do poleceń powłoki i zapisu plików, bez obchodzenia uprawnień przez echo, cat czy heredoc.

Oryginalny opis (EN)

Proper usage of Bash and file operation tools. Use this skill when executing shell commands, writing files, or when tempted to use echo/cat/heredoc to pipe content to files. Prevents permission circumvention patterns like piping multiline content through echo instead of using Write tool. Covers Bash tool, Write tool, Edit tool, and Read tool best practices.

Jak działa

  1. Core Principle
  2. Tool Selection Decision Tree
  3. Prohibited Patterns
  4. Tool References
  5. When Write Tool is Blocked
  6. Updating This Skill
  7. Quick Reference
Sekcje z nagłówków SKILL.md, w oryginale · 87 linii, 469 słów
Podgląd SKILL.md
---
name: bash-tools
description: Proper usage of Bash and file operation tools. Use this skill when executing shell commands, writing files, or when tempted to use echo/cat/heredoc to pipe content to files. Prevents permission circumvention patterns like piping multiline content through echo instead of using Write tool. Covers Bash tool, Write tool, Edit tool, and Read tool best practices.
---

# Bash Tools

Guidelines for proper tool selection when executing commands or modifying files.

## Core Principle

**Use specialized file tools for file operations. Use Bash only for actual shell commands.**

Never use Bash to circumvent file operation permissions. If Write tool is blocked, that's intentional - do not work around it with `echo`, `cat`, or heredocs.

## Tool Selection Decision Tree

```
Need to create/overwrite a file?
├── YES → Use Write tool (NOT echo/cat/heredoc)
└── NO → Continue...

Need to edit part of a file?
├── YES → Use Edit tool (NOT sed/awk)
└── NO → Continue...

Need to read file contents?
├── YES → Use Read tool (NOT cat/head/tail)
└── NO → Continue...

Need to search file contents?
├── YES → Use Grep tool (NOT grep/rg in Bash)
└── NO → Continue...

Need to find files by pattern?
├── YES → Use Glob tool (NOT find/ls in Bash)
└── NO → Continue...

Is this an actual shell command? (git, npm, docker, make, etc.)
├── YES → Use Bash tool
└── NO → Reconsider - probably need a file tool
```

## Prohibited Patterns

These patterns attempt to circumvent Write tool permissions and MUST NOT be used:

| Pattern | Why It's Wrong | Correct Approach |
|---------|---------------|------------------|
| `echo "content" > file.py` | Bypasses Write permissions | Use Write tool |
| `cat << 'EOF' > file.py` | Heredoc bypasses permissions | Use Write tool |
| `printf '%s' "$content" > file` | Same as echo bypass | Use Write tool |
| `tee file.py <<< "content"` | Redirect bypass | Use Write tool |

See [references/permission-patterns.md](references/permission-patterns.md) for comprehensive examples.

## Tool References

- [Write Tool](references/write-tool.md) - Creating and overwriting files
- [Bash Tool](references/bash-tool.md) - Running shell commands
- [Edit Tool](references/edit-tool.md) - Modifying existing files
- [Read Tool](references/read-tool.md) - Reading file contents

## When Write Tool is Blocked

If the Write tool is blocked for a file:

1. **Accept the block** - It exists for a reason
2. **Ask the user** if they want to allow the operation
3. **Do NOT** attempt to use Bash to write the file instead

The permission system protects the user. Circumventing it defeats its purpose.

## Updating This Skill

When encountering new permission circumvention patterns or tool usage issues, see [references/updating-skill.md](references/updating-skill.md).

## Quick Reference

| Task | Tool | NOT This |
|------|------|----------|
| Create file | Write | `echo > file` |
| Edit file | Edit | `sed -i` |
| Read file | Read | `cat file` |
| Search content | Grep | `grep pattern` |
| Find files | Glob | `find . -name` |
| Git commands | Bash | - |
| npm/yarn | Bash | - |
| docker/make | Bash | - |
| Run tests | Bash | - |
Pliki w paczce (7)
  • SKILL.md 3 KB
  • references/bash-tool.md 2 KB
  • references/edit-tool.md 2 KB
  • references/permission-patterns.md 3 KB
  • references/read-tool.md 2 KB
  • references/updating-skill.md 3 KB
  • references/write-tool.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie bash-tools.

Migawka bazy z 13.11.2026 · wersja paczki 9ed5907a1f82 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 95harness-tool-errors
    Wyjaśnia błędy narzędzi Claude Code: Read na brakującej ścieżce lub zbyt dużym pliku, Edit przed Read lub po formatterze oraz odmowy uprawnień w Bash.
  • 92write-script-bash
    Prowadzi przez pisanie skryptów w Bash zgodnie z konwencjami tej platformy.
  • 95bash-linux
    Podaje wzorce powłoki Bash i Linux oraz macOS: operatory, pliki, procesy, narzędzia tekstowe i skrypty.
  • 100context-mode
    Przetwarza duże wyniki za pomocą narzędzi ctx_execute i ctx_execute_file zamiast Bash i cat: analiza logów, parsowanie JSON, migawki stron, wyniki testów i budowania.
  • 100shell-expert
    Wspiera skrypty powłoki, narzędzia wiersza poleceń i automatyzację międzyplatformową w bash, zsh i POSIX: potoki, pisanie przenośnych skryptów i użycie poleceń CLI.
  • 100mcp-bash
    Buduje, debuguje i pakuje serwery MCP napisane w Bashu we frameworku mcp-bash: narzędzia, zasoby, prompty, podłączenie do Claude Desktop lub Cursor oraz diagnozowanie blokad polityki i zmiennych środowiskowych.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.