Skip to content

Comments

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

Draft
Kovbo wants to merge 9 commits intoOpenPipe:mainfrom
Kovbo:feat/agentic-exp
Draft

feat: install-skills creates CLAUDE.md for AI discoverability#574
Kovbo wants to merge 9 commits intoOpenPipe:mainfrom
Kovbo:feat/agentic-exp

Conversation

@Kovbo
Copy link
Collaborator

@Kovbo Kovbo commented Feb 19, 2026

Summary

  • Adds a module docstring to art/__init__.py that directs AI coding assistants to run uv run art install-skills before attempting to help with training
  • Explicitly tells assistants not to scan source code or suggest CLI commands, and not to search site-packages for skills
  • Explains that the command copies SKILL.md files into .claude/skills/ and .agents/skills/ in the project directory

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, recommending CLI commands like art train-sft, or trying to find skills in site-packages — missing the curated skill workflows entirely. The docstring bridges this gap by giving explicit, actionable instructions.

Test plan

  • Verify art/__init__.py docstring renders correctly via python -c "import art; help(art)"
  • In a fresh project with openpipe-art installed, verify an AI assistant reads the docstring and runs uv run art install-skills

🤖 Generated with Claude Code

Kovbo and others added 7 commits February 19, 2026 14:15
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>
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 marked this pull request as draft February 19, 2026 23:31
Kovbo and others added 2 commits February 19, 2026 15:40
Remove `art train-sft` and `art train-rl` CLI wizards — users interact
with ART through AI coding assistants, not standalone CLI wizards.

Add `art init` to initialize a project with skill files (replaces
`install-skills` which is kept as an alias). Add `art help` that
explains the setup flow for agents.

Update __init__.py docstring to reference `art init`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Keep install-skills as the primary command with full docstring and
output. init calls install-skills and can be extended later.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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