Add cross-tool AI distribution: npx skills, llms.txt index, Context7 config - #268
Merged
Conversation
…ext7 config The plugin's skills already follow the cross-tool agent-skills format, and npx skills discovers them through .claude-plugin/marketplace.json. Tested against this repo: all six plugin skills surface. The maintainer release skill leaked into that discovery too, so it now carries metadata.internal: true (hidden from distribution, still loads locally). README gains an AI-Assisted Development section: plugin install for Claude Code, npx skills for everything else, llms bundle links, and Context7. The plugin README documents the npx path alongside the existing install routes. The docs site served its llms bundles only under /_static/ (verified: root URLs 404 live). generate_llms_files.py now also emits a spec-compliant llms.txt index (small markdown nav with key API facts, guide links, and bundle links; all URLs verified against the live site), and CI copies index + bundles to the site root where the convention expects them. context7.json at the repo root controls Context7 indexing and surfaces the v2 API rules (top-level imports, generics, Instructor-wrapped client, docstring requirement, provider knobs) to assistants that pull docs from there. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Second slice of the AI DX upgrade, stacked on #267. Makes the AI-assist surface we already ship reachable from outside Claude Code.
npx skills works today. Tested
npx skills add eigenwise/atomic-agentsagainst this repo: the CLI discovers all six plugin skills through.claude-plugin/marketplace.json. No restructuring needed. One catch: it also picked up the maintainer-onlyreleaseskill from.claude/skills/(which publishes to PyPI, not something consumers should be offered). Fixed withmetadata.internal: truefrontmatter, re-tested locally: 6 skills, release hidden, still loads fine in Claude Code.README gets an AI-Assisted Development section. The plugin, the npx path, the llms bundles, and Context7 were all invisible from the repo front page and PyPI. Now they're one section with install commands.
llms.txt front door. The docs site already generates
llms-full/docs/source/examples.txtin CI, but served them only under/_static/(root URLs 404, verified live). The generator now also emits a spec-compliantllms.txtindex (short markdown nav with key v2 API facts, guide links, bundle links), and CI places index + bundles at the site root where agents probe by convention. Every URL in the index checked against the live site (all 200s).context7.json. Atomic Agents is already indexed on Context7 (1,462 snippets). The new config file controls what gets indexed and ships six v2 API rules to assistants pulling docs from there (top-level imports,
AtomicAgent[In, Out]generics, Instructor-wrapped client, docstring requirement, provider knobs, Gemini/Anthropic quirks).Verified
npx skills add <local-path> --list: exactly the 6 plugin skills,releasehiddengenerate_index()output starts with H1 + blockquote per llmstxt.org speccontext7.jsonmatches the published schema (fields verified against context7.com/docs/library-owners)Note: the root llms URLs in the README go live on the next docs deploy after merge.
🤖 Generated with Claude Code