FreePublished on GitHub

bash-tools

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.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge

See how to install

Files included (7)

SKILL.md3.2 KB
references/bash-tool.md1.9 KB
references/edit-tool.md1.9 KB
references/permission-patterns.md3.2 KB
references/read-tool.md1.8 KB
references/updating-skill.md2.5 KB
references/write-tool.md1.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 for comprehensive examples.

Tool References

Write Tool - Creating and overwriting files
Bash Tool - Running shell commands
Edit Tool - Modifying existing files
Read Tool - Reading file contents

When Write Tool is Blocked

If the Write tool is blocked for a file:

Accept the block - It exists for a reason
Ask the user if they want to allow the operation
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.

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	-

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

aesthetic

Free

Create aesthetically beautiful interfaces following proven design principles. Use when building UI/UX, analyzing designs from inspiration sites, generating design images with ai-multimodal, implementing visual hierarchy and color theory, adding micro-interactions, or creating design documentation. Includes workflows for capturing and analyzing inspiration screenshots with chrome-devtools and ai-multimodal, iterative design image generation until aesthetic standards are met, and comprehensive design system guidance covering BEAUTIFUL (aesthetic principles), RIGHT (functionality/accessibility), SATISFYING (micro-interactions), and PEAK (storytelling) stages. Integrates with chrome-devtools, ai-multimodal, media-processing, ui-styling, and web-frameworks skills.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge15Updated Oct 19, 2026

brand

Free

DraftForge brand/theming review. Flags raw <button> over PrimaryButton/SecondaryButton, hardcoded violet/slate over brand tokens, inline styles, missing UserAvatar/EntityBreadcrumb.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge15Updated Oct 19, 2026

chrome-devtools

Free

Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge15Updated Oct 19, 2026

django-redis-caching

Free

Django Redis caching with django-cacheops. This skill should be used when implementing caching, adding cache invalidation, optimizing API performance, modifying models that affect cached data, or debugging cache-related issues in the Django backend.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge15Updated Oct 19, 2026

frontend-dev-guidelines

Free

Frontend development guidelines for React/TypeScript applications. Modern patterns including Suspense, lazy loading, useSuspenseQuery, file organization with features directory, MUI v7 styling, TanStack Router, performance optimization, and TypeScript best practices. Use when creating components, pages, features, fetching data, styling, routing, or working with frontend code.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge15Updated Oct 19, 2026

inv-runner

Free

Python Invoke task automation for DTX website. This skill should be used when running repo commands, backend tests via Docker, database migrations, updating invoke tasks, Docker operations, or workflow automation. Supports dev/test/prod environments with run, exec, up, down commands. References docs/development/invoke-tasks.md for complete command reference.

The English summary is being prepared. Showing the original description.

kettleofketchup/DraftForge15Updated Oct 19, 2026

See all skills by kettleofketchup

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/kettleofketchup/DraftForge --skill bash-tools

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/kettleofketchup/DraftForge/tree/main/.claude/skills/bash-tools

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/bash-tools/ for Claude Code, or ~/.agents/skills/bash-tools/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: kettleofketchup/DraftForge
Stars: 15
Forks: 0
Category: Other
License: GPL-3.0
Original language: English
Last updated: Oct 19, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.