BluscreamandClaude Opus 5
9571eb52d2
- suppressions: prefer the narrowest scope that covers the problem (line, function, module) with a reason comment; a project-wide disable silences the rule in code nobody has written yet. Always name the specific rule. Propagated to rust (#[allow]), csharp (#pragma/SuppressMessage). - precedence: a project's own rules win only when contributing upstream. For local/private work these rules win, adopting only the project's load-bearing conventions. - type checking must pass with zero errors *or warnings*. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Public Agent Skills
A collection of public, reusable agent skills, cheatsheets, and operational workflows for AI coding assistants and automation agents.
📂 Skills Index
| Skill File | Scope / Topics Covered |
|---|---|
coding-dev.md |
Standing rules for all code work: maximum linter/compiler strictness, never filtering build output, reuse-before-reinvent dependency ordering, file/function size limits, test & regression discipline, verification gates, scope control, commit hygiene, and honest reporting. |
🔤 Per-Language Rules (code-languages/)
| Language | Skill File | Highlights |
|---|---|---|
| Rust | rust.md |
--workspace clippy gate, [workspace.lints] single source of truth, no unwrap/unsafe, core-crate split |
| TypeScript / JavaScript | js-typescript.md |
TS > JSDoc > plain JS, banned constructs table, React & hooks rules, resource lifecycle, sandbox boundaries |
| Bash / Shell | bash.md |
set -euo pipefail, shellcheck, no wait loops, destructive-command guards, build-gate structure |
| Python | python.md |
mypy --strict, broad ruff rule set, asyncio task discipline, rate-limit queueing |
| Go | go.md |
strict golangci-lint set, concrete types over interface{}, context everywhere, CGO-free static builds |
| C# / .NET | csharp-dotnet.md |
TreatWarningsAsErrors, nullable enabled, no .Result, trimming/single-file publish caveats, SDK shims |
| C / C++ | c-cpp.md |
full warning set + -Werror, sanitizers, RAII/Rule of Zero, target-based CMake, FFI ownership |
Each language file extends coding-dev.md rather than repeating it. A project's own
AGENTS.md / CLAUDE.md / .rules always overrides both.
✍️ Skill Document Conventions
Skills in this repo follow the same structure as the private counterpart repo, so agents can load either interchangeably:
- YAML frontmatter with
name(kebab-case, matching the filename) and adescriptionstarting with "Use this skill when …" — the description is what an agent matches against to decide relevance, so it must enumerate concrete triggers. - Numbered
##sections, sequential and unique, ending with a Related Skills section that cross-links sibling documents. - CLI discovery over enumeration — document the non-obvious workflows, gotchas, and constraints. For the routine surface, point at
<tool> --helprather than transcribing flag lists that will go stale. - No secrets inline — reference the environment file that holds them (e.g.
~/.config/environment.d/…), never the values themselves. - Verify before documenting — confirm hostnames, container names, and versions against the live system rather than carrying forward stale claims.
🛠️ Usage Across AI Agents & Tools
These skill documents are compatible across agentic developer assistants and environments:
- Claude Code / Claude Desktop: Symlink or reference in project instructions or memory.
- Codex: Include in workspace instructions or agent configuration.
- Antigravity: Mount or reference from workspace
.agents/skills/or global~/.gemini/config/skills/. - Other AI Tools (Cursor, OpenCode, Aider, Devin): Include as persistent project rules or context files.