Skip to content

Instantly share code, notes, and snippets.

View bkataru's full-sized avatar
🌩️
boomin at da speed of c ⚡🔧

Baalateja Kataru bkataru

🌩️
boomin at da speed of c ⚡🔧
View GitHub Profile
@bkataru
bkataru / SKILL.md
Created October 20, 2026 00:26
no-compat-paths: convert once, delete the old shape, no legacy debt (agent skill)
name no-compat-paths
description Use for ANY software project, language, or codebase when a change touches a data format, schema, field, storage layout, serialization, API, or config — or whenever you think "compat path", "backward compatibility", "legacy support", "migration shim", "dual format", "deprecation alias". Default stance: convert old data once and delete the old machinery; breaking churn is fine.

No compat paths, no legacy debt

A default engineering stance for all software work — any project, language, repo, file, or folder. Treat it as the rule unless an explicit external contract says otherwise, and even then, surface the decision to the owner instead of silently adding compat code.

@bkataru
bkataru / SKILL.md
Created October 20, 2026 00:26
prefer-established-crates: use established crates, don't hand-roll machinery (KISS/DRY/YAGNI agent skill)
name prefer-established-crates
description Prefer established crates over hand-rolled machinery (KISS/DRY/YAGNI): ecosystem defaults, transitive-cost measurement, feature/MSRV/license/audit gates, and a review checklist

Prefer the ecosystem: use established crates, don't hand-roll machinery

Default stance for all software work. The standard library is not batteries-included; the ecosystem exists to fill the gaps. Hand-rolled machinery for a solved problem is a defect signal, not craft.

@bkataru
bkataru / .gitignore.ada
Created June 23, 2026 03:17
.gitignore.ada
# Ada build artifacts
*.o
*.ali
*.a
*.so
*.dll
*.exe
*.dSYM/
# GNAT/GPR build outputs
@bkataru
bkataru / microgpt.py
Created March 2, 2026 01:05 — forked from karpathy/microgpt.py
microgpt
"""
The most atomic way to train and run inference for a GPT in pure, dependency-free Python.
This file is the complete algorithm.
Everything else is just efficiency.
@karpathy
"""
import os # os.path.exists
import math # math.log, math.exp
@bkataru
bkataru / markdown-newlines-skill.md
Created February 25, 2026 02:22
Markdown Newline Escaping in Bash/CLI — why \n appears instead of line breaks and how to fix

Skill: Markdown Newline Escaping in Bash/CLI Commands

Problem

When creating GitHub PRs, issues, or comments via gh CLI commands with multi-line markdown content, newlines are being escaped as literal \n strings instead of actual line breaks.

Example of Broken Output

## Summary\n\nFix duplicate symbol errors...\n\n## Problem\n\nclip.cpp was being compiled twice...
@bkataru
bkataru / gist:64d379ca7e5114654dffc97d281daf26
Created February 24, 2026 23:56
SKILL: Rust CLI/Storage QA Gotchas — TOML arrays, format parser header vs label, MCP stdout, LevelDB iterator
# Skill: Rust CLI & Storage QA Gotchas
> Concrete bugs found during dogfood QA of a Rust CLI tool with SQLite, TOML, LevelDB, and MCP. Each pattern recurs in other projects.
---
## 1. TOML Does Not Support Top-Level Arrays
`toml::to_string(&Vec<T>)` returns `Err("unsupported rust type")` — TOML requires a top-level table, not an array.
@bkataru
bkataru / gist:ba0e7cb4fd43bf1a0ed2a96ed124b99b
Created February 24, 2026 23:55
SKILL: Chrome Extension LevelDB Recovery — rusty_leveldb pitfalls, double-encoded JSON, hot-copy corruption, Edge WAL extraction
# Skill: Chrome Extension LevelDB Recovery
> Recovering data from Chrome/Edge/Brave extension LevelDB stores (e.g., OneTab, 1Password, any browser extension that uses `chrome.storage.local`).
---
## Extension Storage Paths
| Browser | Extension LevelDB path |
|---------|----------------------|
@bkataru
bkataru / skill-claude-code-spawning-background-agents.md
Created February 24, 2026 16:13
SKILL: Spawning & Monitoring Background Coding Agents from Claude Code — phase pipeline pattern, prompt templates, model selection

Skill: Spawning & Monitoring Background Coding Agents from Claude Code

Patterns for orchestrating long-running AI coding agents from within a Claude Code session.


The Core Pattern

Use Bash tool with run_in_background: true to launch agents, redirect output to a file, and poll progress without blocking the main session.

@bkataru
bkataru / skill-opencode-custom-agents.md
Created February 24, 2026 16:13
SKILL: Configuring Custom Agents in OpenCode — native opencode.json config, OMO oh-my-opencode.json, markdown agent files

Skill: Configuring Custom Agents in OpenCode

How to define custom agents natively in opencode and via oh-my-opencode.


Two Configuration Systems

OpenCode has its own native agent configuration, and oh-my-opencode (OMO) extends it with a separate config for its built-in agents. They coexist.

@bkataru
bkataru / skill-oh-my-opencode-ralph-loop.md
Created February 24, 2026 16:13
SKILL: oh-my-opencode (OMO) Ralph Wiggum Loop & Agent Invocation — correct usage, pitfalls, agent behavior observations

Skill: oh-my-opencode (OMO) — Ralph Wiggum Loop & Agent Invocation

Learnings from using OMO to autonomously implement multi-phase Rust projects.


What is oh-my-opencode?

oh-my-opencode is an OpenCode plugin that adds:

  • Ralph Wiggum loop — runs the agent until ALL todos complete, not just one turn