Skip to content

docs: restructure around core / strands / adk / langchain with tabbed getting-started#15

Open
skillos-bot wants to merge 2 commits into
mainfrom
claude/gifted-edison-fb6v60
Open

docs: restructure around core / strands / adk / langchain with tabbed getting-started#15
skillos-bot wants to merge 2 commits into
mainfrom
claude/gifted-edison-fb6v60

Conversation

@skillos-bot

Copy link
Copy Markdown
Collaborator

Summary

Restructures the README and docs to reflect the two-layer architecture: a backend-agnostic skillos-core and three SDK-specific "languages" (Strands, ADK, LangChain).

  • README: replaces the flat packages list with an architecture table (core + three SDK rows) and a tabbed quick-start showing hook/plugin/callback wiring for each framework
  • docs/index.md: split into a skillos-core interfaces section and an SDK integrations section with a per-framework table
  • docs/getting-started.md: rewritten as a tabbed "three languages" guide — Strands, ADK, LangChain — covering install, skill repo layout, curator wiring (hook/plugin/callback), remote backends, and write operations in each tab
  • docs/api/skillos-core.md: extended with Curator, ConversationHistory, Changelog, Change, and ChangeKind
  • docs/api/skillos-strands.md: new — StrandsCurator (hook() + curate()) and create_skill_tools reference
  • docs/api/skillos-adk.md: new — ADKCurator (plugin() + curate()) and create_skill_tools reference
  • mkdocs.yml: adds pymdownx.tabbed, navigation.tabs, content.tabs.link; adds both new API pages to the nav

Test plan

  • mkdocs serve renders without errors
  • Tabbed code blocks in Getting Started switch correctly between Strands / ADK / LangChain
  • All API cross-links (e.g. [Changelog](skillos-core.md#changelog)) resolve correctly
  • README tabs render on GitHub (note: GitHub strips tab syntax; prose fallback is readable)

https://claude.ai/code/session_01Fquq8y7VojxfTYXthtFxcU


Generated by Claude Code

claude added 2 commits May 28, 2026 20:13
Mirrors skillos-strands for Google's Agent Development Kit (google-adk):

- create_skill_tools(): five FunctionTool wrappers (list/read/insert/
  update/delete) over a SkillRepo, recording mutations to a Changelog.
- ADKCurator(Curator): builds an LlmAgent armed with the skill tools,
  feeds it the formatted conversation history, and runs it via an
  InMemoryRunner.
- ADKCurator.plugin(): returns a BasePlugin (the ADK analogue of a
  Strands HookProvider) whose after_run_callback converts session events
  into a ConversationHistory and hands them to the curator.

Includes unit tests for tools, history formatting, event conversion, and
the plugin, plus end-to-end tests driving user session events through the
plugin into the curator and asserting the resulting repo/Changelog state.

Enables pytest importlib import mode so packages can share test-module
basenames without sys.modules collisions.
… getting-started

- README: adds architecture table (core + three SDKs) and tabbed quick-start
  showing hook/plugin/callback integration for Strands, ADK, and LangChain
- docs/index.md: two-section layout — core interfaces table + SDK integrations
  table — so readers can jump straight to the right package
- docs/getting-started.md: rewritten as a tabbed "three languages" guide
  covering install, skill repo layout, curator wiring, remote backends, and
  write operations for each of the three SDK choices
- docs/api/skillos-core.md: extended with Curator, ConversationHistory,
  Changelog, Change, and ChangeKind
- docs/api/skillos-strands.md: new — StrandsCurator (hook() + curate()) and
  create_skill_tools reference
- docs/api/skillos-adk.md: new — ADKCurator (plugin() + curate()) and
  create_skill_tools reference
- mkdocs.yml: adds pymdownx.tabbed, navigation.tabs, content.tabs.link;
  adds skillos-strands and skillos-adk to the API reference nav

https://claude.ai/code/session_01Fquq8y7VojxfTYXthtFxcU
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.

2 participants