MithunWijayasiri/dotclaude

My Claude Code setup: output styles, CLAUDE.md, rules, and skills.
---
Plain markdown files for ~/.claude. *Output styles* shape how Claude answers, *skills* add repeatable jobs, *rules* load by file type, and CLAUDE.md sets the defaults.
Table of contents
- Output styles
- CLAUDE.md
- Rules
- Skills
- Install
Output styles
> [!TIP]
> The project page compares ASD-STE100 with Claude Code's built-in Concise and Default on the same question.
ASD-STE100
Claude answers in ASD-STE100 Simplified Technical English: short sentences, everyday words, one word per meaning, active voice. The result comes first, then labelled bullets (Verified:, Updated:, Skipped:, Remaining:, Next:). Claude never rewords code or commands.
CLAUDE.md
Standing instructions for every session: General, Engineering, File & Command Safety, Comments, Code Review Findings, External Docs. Copy it to ~/.claude/CLAUDE.md, or to a repo root for one project.
External Docs sends library questions to context7, an MCP server. Without it, Claude falls back to a web search. Connect it once:
> [!TIP]
> Get a free key from the context7 dashboard. To run the server locally instead: claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY.
Rules
A rule is a .md file in ~/.claude/rules/ that loads when Claude touches a file matching its paths: glob.
- **compact-markdown**. On any **/*.md, points Claude at the compact-markdown skill. Keeps code, commands, and concrete details verbatim. README is exempt.
Skills
A skill is a procedure for one job. Claude Code loads it on demand. See skills/README.md for usage.
- **compact-markdown**. Telegraphic markdown for AI-facing docs. Strips filler, keeps code and examples.
- **ask-first**. Ask clarifying questions before acting instead of guessing. One question at a time, each with a recommended answer.
- **handoff-session**. Hand the whole session over: state, decisions, blockers, next steps. Drops detail that no longer matters.
- **offload-task**. Write one stuck problem into a standalone brief for a fresh session: goal, failing behaviour, repro, and every attempt with its result, whether a code change or a manual check.
- **claude-project-rules**. Author .claude/rules/*.md with correct paths: scoping, lazy-load, and shared-rule symlinks.
- **html-landing-page**. Design a distinctive static landing page with the frontend-design skill. Plan palette, type, and one signature element before any HTML. Manual: /html-landing-page.
- **git-merge**. Merge a branch into yours without losing local unstaged work. A recon script maps the conflicts first. Claude then resolves each one and runs the repo's own checks to catch changes git merged without a conflict but wrongly.
- **git-worktree**. Start a worktree with node_modules junctioned and .env copied, so it runs without a reinstall. Windows and PowerShell only.
- **empty-commit**. Push an empty commit to re-run CI when a pipeline failed on something unrelated. Refuses to run with staged files, on the default branch, or without an upstream. Manual: /empty-commit.