Where do I put a Claude Code Skill so it is available?

There are two places: ~/.claude/skills/ /SKILL.md for all of your own projects, and .claude/skills/ /SKILL.md for just that repository, which can be shared via git.

How is a Skill different from CLAUDE.md?

Claude reads only the description first and loads the body only when the skill is used, so a long body barely consumes everyday context — which the article calls the big difference from CLAUDE.md.

How do I stop Claude from guessing when information is missing?

Write the behavior into the skill: for meeting minutes, the article's rule is not to fill gaps with guesses but to write “(要確認)” and not stop the work to ask questions.

Large Language ModelsAI Coding AssistantsZenn AI/ML8h agoOct 1, 2026, 10:00 JST

Claude Code Skills: build Japanese office tasks with SKILL.md

Send on LINE

3 Key Points

What happened
After building 12 Claude Code Skills for Japanese business tasks, the author published the recipe and the full gijiroku meeting-minutes SKILL.md, noting that skills live in ~/.claude/skills/<name>/SKILL.md or .claude/skills/<name>/SKILL.md.
Why it matters
Only the description is read up front and the body loads when the skill is used, so long instructions barely consume everyday context — unlike CLAUDE.md, according to the author.
What to watch
Reliable triggering hinges on putting Japanese request phrases in the description, and calculations like consumption tax and withholding should be handed to a bundled Python script via ${CLAUDE_SKILL_DIR} and allowed-tools rather than left to the model.

WHO IT HITSThis lands on Japanese back-office and operations staff — and the people who write their templates — who currently paste the same instructions into chat each time: the article shows they can turn minutes, daily reports, invoices, and keigo emails into reusable files. It also matters to developers maintaining shared team workflows, since a repo-level skill can be shared via git.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Get news like this every morning, free

FAQ

Where do I put a Claude Code Skill so it is available?: There are two places: ~/.claude/skills/<name>/SKILL.md for all of your own projects, and .claude/skills/<name>/SKILL.md for just that repository, which can be shared via git.
How is a Skill different from CLAUDE.md?: Claude reads only the description first and loads the body only when the skill is used, so a long body barely consumes everyday context — which the article calls the big difference from CLAUDE.md.
How do I stop Claude from guessing when information is missing?: Write the behavior into the skill: for meeting minutes, the article's rule is not to fill gaps with guesses but to write “(要確認)” and not stop the work to ask questions.

Zenn AI/MLRead Original Article

Send on LINE

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Get it free

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.