Bainary Skill
BainaryTD/bainary-skill
Skill que aprende seu projeto e gera código alinhado com seus padrões
Ver no GitHubSkill foundacional para desenvolvimento web que aprende o contexto do seu projeto antes de gerar código. Captura padrões de estilo e mantém conhecimento entre sessões, funcionando com múltiplas CLIs de IA (Claude, Cursor, Codex, Grok). Implementa princípios de Karpathy como análise antes da codificação e mudanças cirúrgicas.
Instalação
npx convez-ai BainaryTD/bainary-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter consistência de código entre múltiplas sessões de IA
- Acelerar desenvolvimento web capturando padrões existentes
- Documentar contexto do projeto para handoff entre diferentes CLIs de IA
Veredito

Skill bem-arquitetado para Windows/macOS/Linux que resolve o problema real de manter contexto entre sessões de IA. Implementação sólida com suporte multiplataforma, embora requeira familiaridade com CLI para máximo proveito.
README
A tradução para o português deste README ainda está na fila.
bainary-skill
Web Development Base Skill with Project Learning & Multi-CLI Support
What is bainary-skill?
bainary-skill เป็น foundational skill สำหรับ web development ที่:
- 🧠 เรียนรู้ project ของคุณ ก่อน generate code ทุกครั้ง
- 🎨 จับ project style/code patterns จาก codebase จริงในแชทแรก
- 🔄 รักษา knowledge ข้ามหลาย session
- 🧾 บันทึก session handoff หลังคุยกับ AI เสร็จ เพื่อเปิดแชทใหม่แล้วต่อเนื่อง
- 🤖 รองรับทุก AI CLI — Claude Code, Cursor, Codex, Grok, Aider
สร้างบน Karpathy's core principles:
| Principle | ความหมาย |
|---|---|
| Think Before Coding | วิเคราะห์และวางแผนก่อนเขียนโค้ด |
| Simplicity First | เลือก solution ที่ง่ายและ maintain ได้ |
| Surgical Changes | แก้แค่ที่จำเป็น ไม่แตะโค้ดที่ไม่เกี่ยว |
| Goal-Driven Execution | ทุก change ต้องมี verifiable goal |
Installation
🪟 Windows — ไม่ต้องใช้ WSL หรือ bash
CMD.exe
Project-local install (เฉพาะ project นั้น):
cd your-project
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.cmd -OutFile install.cmd; .\install.cmd --local"
ใช้งาน:
.\bin\bainary-skill.cmd learn
.\bin\bainary-skill.cmd update
.\bin\bainary-skill.cmd status
PowerShell
Global install (ใช้ได้ทุก project):
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 | iex
Project-local install (เฉพาะ project นั้น):
cd your-project
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 -OutFile install.ps1
.\install.ps1 -Local
ใช้งาน (หลัง global install):
bainary-skill learn
bainary-skill update
bainary-skill status
ใช้งาน (project-local):
.\bin\bainary-skill.cmd learn
# หรือถ้ามี package.json:
npm run bainary -- learn
🐧 macOS / Linux (bash)
🌍 Global Install (แนะนำสำหรับใช้ข้าม project)
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash
ใช้ได้ทุกที่ในเครื่อง:
bainary-skill learn
bainary-skill update
bainary-skill status
📁 Project-Local Install (เฉพาะ project นั้น)
cd your-project
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash -s -- --local
ติดตั้งที่ ./bin/bainary-skill และ auto-add npm script (ถ้ามี package.json):
./bin/bainary-skill learn
# หรือถ้ามี package.json:
npm run bainary -- learn
ทำไมต้อง project-local?
- ไม่ต้องติดตั้ง global บนทุกเครื่อง
- แต่ละ project ใช้ version ที่ตัวเองต้องการได้
- ทำงานได้ใน CI/CD โดยไม่ต้อง pre-install
⚡ npx (ไม่ต้อง install เลย)
npx github:BainaryTD/bainary-skill learn
Quick Start
1. ติดตั้ง
Windows CMD.exe:
# Project-local
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.cmd -OutFile install.cmd; .\install.cmd --local"
Windows PowerShell:
# Global
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 | iex
# หรือ project-local
irm https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.ps1 -OutFile install.ps1
.\install.ps1 -Local
macOS / Linux:
# Global
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash
# หรือ project-local
curl -sL https://raw.githubusercontent.com/BainaryTD/bainary-skill/main/install.sh | bash -s -- --local
2. Initialize project
cd your-web-project
bainary-skill learn # หรือ ./bin/bainary-skill learn (project-local)
3. กรอก knowledge files / ให้ AI เรียนรู้ project style
.bainary/
├── project-knowledge.md ← อธิบาย project ของคุณ
├── session-handoff.md ← สรุปแชทล่าสุด + next steps เพื่อเปิดแชทใหม่ต่อเนื่อง
├── architecture.md ← key design decisions
├── patterns.md ← code patterns ที่ใช้
└── conventions.md ← naming & folder rules
ในแชทแรกของ AI ให้ใช้ prompt นี้ก่อนสั่งเขียนโค้ด:
Read .bainary/project-knowledge.md, .bainary/session-handoff.md,
.bainary/architecture.md, .bainary/patterns.md, and .bainary/conventions.md.
Then inspect the existing source code to learn this project's coding style,
folder structure, naming conventions, component/API patterns, testing style,
and dependencies. Update .bainary/patterns.md, .bainary/conventions.md,
and .bainary/project-knowledge.md with missing findings before coding.
ก่อนจบแชทกับ AI ให้ใช้ prompt นี้:
Before finishing, update .bainary/session-handoff.md with the current focus,
what changed, decisions made, files touched, risks, and next steps. Move any
stable new style/convention/pattern knowledge into .bainary/patterns.md,
.bainary/conventions.md, or .bainary/architecture.md so the next AI chat can continue.
4. เปิด AI CLI แล้วเริ่มโค้ดได้เลย
claude # Claude Code
codex # Codex
cursor . # Cursor IDE
aider # Aider
CLI Commands
| Command | Description |
|---|---|
bainary-skill learn | สร้าง .bainary/ + session-handoff.md + ติดตั้ง CLI instruction files |
bainary-skill update | Refresh CLI files จาก latest skill version |
bainary-skill status | แสดงสถานะ knowledge files และ CLI files |
bainary-skill install | ติดตั้งใหม่ (project-local) |
bainary-skill install --global | ติดตั้งใหม่แบบ global |
Supported AI CLIs
| CLI | File ที่ติดตั้ง | Status |
|---|---|---|
| Claude Code | CLAUDE.md | ✅ |
| Cursor | .cursorrules + CURSOR.md | ✅ |
| Codex | AGENTS.md | ✅ |
| Grok | AGENTS.md | ✅ |
| Aider | CONVENTIONS.md | ✅ |
Project Knowledge System
หลังจาก bainary-skill learn project จะมี .bainary/ directory:
.bainary/
├── project-knowledge.md # Overview, tech stack, entry points
├── session-handoff.md # Last chat summary, decisions, risks, next steps
├── architecture.md # Architecture decisions + data flow
├── patterns.md # Code patterns (fetching, state, forms ฯลฯ)
└── conventions.md # Naming, folder structure, commit style
AI CLI ทุกตัวจะอ่านไฟล์เหล่านี้ก่อนเขียนโค้ด — ทำให้ AI เข้าใจ project context ของคุณ
Continuity Loop
- เริ่มโปรเจกต์ / เปิดแชทใหม่: ให้ AI อ่าน
.bainary/ทั้งหมดก่อน - ถ้า style ยังว่าง: ให้ AI inspect codebase แล้วเติม
patterns.md+conventions.md - ระหว่างทำงาน: ถ้ามี decision หรือ pattern ใหม่ ให้บันทึกใน
.bainary/ - ก่อนจบแชท: ให้ AI update
session-handoff.mdเพื่อให้แชทถัดไปต่อได้ทันที
Repository Structure
bainary-skill/
├── SKILL.md # Hermes skill definition
├── README.md # This file
├── CHANGELOG.md # Version history
├── package.json # npm/npx support
├── install.sh # Installer (macOS/Linux/WSL)
├── install.ps1 # Installer (Windows PowerShell)
├── install.cmd # Installer wrapper (Windows CMD.exe)
│
├── scripts/
│ ├── bainary-skill # CLI script (bash)
│ └── bainary-skill.ps1 # CLI script (PowerShell / Windows)
│
├── adapters/ # Per-CLI instruction files
│ ├── claude/CLAUDE.md
│ ├── cursor/.cursorrules
│ ├── cursor/CURSOR.md
│ ├── codex/AGENTS.md
│ ├── grok/AGENTS.md
│ ├── aider/CONVENTIONS.md
│ └── web-project/README.md
│
└── templates/
├── .bainary/ # Project knowledge templates
│ ├── project-knowledge.md
│ ├── session-handoff.md
│ ├── architecture.md
│ ├── patterns.md
│ └── conventions.md
└── web-project/ # Web project starter files
├── package.json
└── .gitignore
License
MIT © Bainary