Skip to content

Comments

feat: install-skills creates CLAUDE.md for AI discoverability#573

Closed
Kovbo wants to merge 7 commits intoOpenPipe:mainfrom
Kovbo:feat/install-skills-claude-md
Closed

feat: install-skills creates CLAUDE.md for AI discoverability#573
Kovbo wants to merge 7 commits intoOpenPipe:mainfrom
Kovbo:feat/install-skills-claude-md

Conversation

@Kovbo
Copy link
Collaborator

@Kovbo Kovbo commented Feb 19, 2026

Summary

  • Adds a module docstring to art/__init__.py that points AI coding assistants to art install-skills and the /train-sft / /train-rl slash commands
  • Links to the official docs at https://art.openpipe.ai/getting-started/about
  • Explicitly tells assistants to prefer the skills over reading source code, since the skills provide structured guidance for dataset prep, backend selection, hyperparameters, and script generation

Why this matters

When an AI coding assistant enters a project with openpipe-art installed and a user asks for help with training, the assistant typically reads art/__init__.py to understand the API. Without any hint, it falls back to scanning the source code and piecing together usage from internal implementation details — missing the curated, step-by-step skill workflows entirely. The docstring bridges this gap by surfacing the right entry point early.

Test plan

  • Verify art/__init__.py docstring renders correctly via python -c "import art; help(art)"

🤖 Generated with Claude Code

After copying skill files, `art install-skills` now also creates or
updates a CLAUDE.md at the project root with an ART skills section.
This lets AI coding assistants (Claude Code, etc.) automatically
discover `/train-sft` and `/train-rl` skills when entering a project.

The update is idempotent—re-running the command won't duplicate content,
and existing CLAUDE.md content is preserved.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Kovbo Kovbo marked this pull request as draft February 19, 2026 22:16
Kovbo and others added 6 commits February 19, 2026 14:35
When AI coding assistants read the package source to understand the
API, the module docstring now points them to `art install-skills`
and the `/train-sft` / `/train-rl` slash commands.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Tell AI assistants explicitly NOT to scan source code or suggest CLI
commands, and instead install and use the skills. The previous wording
was too passive — assistants would find the CLI wizard and recommend
that instead of using the skills workflow.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The previous wording led agents to search for skills in site-packages
instead of running the install command. Now the docstring shows the
exact shell command (uv run art install-skills), explains where the
files end up, and explicitly says not to search site-packages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Kovbo Kovbo closed this Feb 19, 2026
@Kovbo Kovbo deleted the feat/install-skills-claude-md branch February 19, 2026 23:28
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.

1 participant