Tips // Claude in practice

Tips for working better with Claude

One short tip at a time, with an example you can copy. Move through them at random or search for what you need.

SkillsAdvancedClaude Agent SDK

Your skill does not load in the Agent SDK: check settingSources

A skill that works in Claude Code may do nothing in the SDK if you never said which sources to load the configuration from.

In the Agent SDK, whether CLAUDE.md and skills are loaded from the filesystem is controlled by settingSources (setting_sources in Python). Do not rely on the default value: declare it explicitly with the sources you want. And remember that subagents start clean: a skill has to be listed explicitly for them.

Example
// TypeScript
settingSources: ["project"]   // adjust to the sources you need
# Python
setting_sources=["project"]
// Check the current values and defaults in the Agent SDK reference.
#agent-sdk#skills#settingSources