claude-code-tips CLAUDE.md
From ykdojo
- Writing: keep user's voice, conversational, stick closely to what user said without making things up, but fix small grammar mistakes
Sets repo conventions for maintaining ykdojo's own CLAUDE.md tips repo and filing Claude Code GitHub issues.
Use it when
- Maintaining this specific tips repo and its table of contents script
- Bumping plugin.json/marketplace.json versions after plugin changes
- Filing a GitHub issue against anthropics/claude-code in this maintainer's style
Skip it if
- Only useful if you maintain this exact repo, not a general tool
- Assumes specific file layout (plugin.json, marketplace.json, generate-toc.js)
- Not applicable if you don't file issues against anthropics/claude-code
Facts
- Repository
- ykdojo/claude-code-tips
- Status
- Actively maintained
- Last commit
- Source file
- CLAUDE.md
Source preview
The instructions Claude Code reads when this claude.md runs.
# Project Instructions
- Writing: keep user's voice, conversational, stick closely to what user said without making things up, but fix small grammar mistakes
- After adding or renaming tips, run `node scripts/generate-toc.js` to update the table of contents
- `~/.claude/CLAUDE.md` is symlinked to `GLOBAL-CLAUDE.md` in this repo
- When committing changes to the plugin (skills, plugin.json, etc.), bump the patch version in both `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json`. Don't bump for non-plugin changes.
- Git tags/releases (e.g. `v0.25.1`) and plugin versions (e.g. `0.14.9`) are separate. The git tag follows the repo release progression and is bumped for any change. The plugin version is only in `plugin.json` and `marketplace.json`.
- After pushing a plugin change, update the local install non-interactively (no `/plugin` menu needed): `claude plugin marketplace update ykdojo` then `claude plugin update dx@ykdojo`. The CLI repopulates the versioned cache; a session restart is required to apply.
# Filing Claude Code GitHub issues
For issues against `anthropics/claude-code`. When I ask you to file one:
- Draft it to a temp file and open it in VS Code (`code <file>`) for me to review before filing - never file without showing me first.
- File from host `gh` (`gh issue create`), not a container.
Style (based on my past issues):
- Title: specific, states thView full source on GitHub →Other claude.md files
ECC CLAUDE.md
★ 229,918This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
affaan-mupdated 15d agoMITui-ux-pro-max-skill CLAUDE.md
★ 105,847This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
nextlevelbuilderupdated 14d agoMITcaveman CLAUDE.md
★ 89,686README = product front door. Non-technical people read it to decide if caveman worth install. Treat like UI copy.
JuliusBrusseeupdated 25d agoMITservers CLAUDE.md
★ 88,502This file provides guidance to Claude Code when working with code in this repository.
modelcontextprotocolupdated 19d agoNOASSERTIONclaude-mem CLAUDE.md
★ 87,329Claude-mem is a Claude Code plugin providing persistent memory across sessions. It captures tool usage, compresses observations using the Claude Agent SDK, and injects relevant context into future ses
thedotmackupdated 13d agoApache-2.0agent-skills CLAUDE.md
★ 78,448This is the agent-skills project — a collection of production-grade engineering skills for AI coding agents.
addyosmaniupdated 16d agoMIT