Skip to content

docs: clarify skill upload file layout#1577

Open
slegarraga wants to merge 1 commit into
anthropics:mainfrom
slegarraga:docs/skill-upload-layout
Open

docs: clarify skill upload file layout#1577
slegarraga wants to merge 1 commit into
anthropics:mainfrom
slegarraga:docs/skill-upload-layout

Conversation

@slegarraga
Copy link
Copy Markdown

Summary

  • document that skill upload paths must be rooted under a directory matching the name field in SKILL.md
  • add a README file upload example and clarify the comprehensive agent example
  • add regression coverage showing anthropic.lib.files_from_dir() preserves the skill top-level directory

Closes #1575.

Tests

  • uv run pytest tests/lib/test_files.py -q
  • uv run pytest tests/lib/test_files.py tests/lib/tools/test_skills.py -q
  • uv run ruff check examples/agents_comprehensive.py src/anthropic/resources/beta/skills/skills.py src/anthropic/resources/beta/skills/versions.py src/anthropic/types/beta/skill_create_params.py src/anthropic/types/beta/skills/version_create_params.py tests/lib/test_files.py
  • uv run pyright tests/lib/test_files.py
  • git diff --check

@slegarraga slegarraga requested a review from a team as a code owner May 20, 2026 16:14
@slegarraga slegarraga force-pushed the docs/skill-upload-layout branch from 61eae3f to 89faea6 Compare May 21, 2026 00:32
@slegarraga
Copy link
Copy Markdown
Author

CI/docs-only PR — ready for review when you have a cycle. Thanks!

@slegarraga
Copy link
Copy Markdown
Author

Docs-only clarification for skill upload layout — ready for review. Thanks.

@slegarraga
Copy link
Copy Markdown
Author

Docs-only clarification for skill upload file layout — low risk, ready for review. Thanks.

@slegarraga
Copy link
Copy Markdown
Author

Docs-only: clarifies skill upload file layout (paths + examples). Low risk, no runtime changes. Review when convenient — thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

beta.skills.create: undocumented requirement that files path prefix must match SKILL.md name: field

1 participant