{"_id":"@2sophia/sophia-motor-skill","_rev":"2-bad3f8ce99ade857f1cdeb13bd856c47","name":"@2sophia/sophia-motor-skill","dist-tags":{"latest":"0.5.1"},"versions":{"0.5.0":{"name":"@2sophia/sophia-motor-skill","version":"0.5.0","keywords":["claude-code","skill","anthropic","claude","agent","agent-sdk","mcp","sophia-motor","ai"],"author":{"name":"Sophia AI","email":"tech@2sophia.ai"},"license":"MIT","_id":"@2sophia/sophia-motor-skill@0.5.0","maintainers":[{"name":"mwspace","email":"app@mwspace.com"}],"homepage":"https://github.com/2sophia/motor","bugs":{"url":"https://github.com/2sophia/motor/issues"},"dist":{"shasum":"97238ae2af8daf3a2410cb75552f6e447892724a","tarball":"https://registry.npmjs.org/@2sophia/sophia-motor-skill/-/sophia-motor-skill-0.5.0.tgz","fileCount":19,"integrity":"sha512-eBf2A3mGPrZpb6xiEC63kJfKwnAYHiWxVSPUA+gImaSTvmoZjbr/X3x23kWw1yMM1MMNakXUntTWJv/vr/S6tw==","signatures":[{"sig":"MEYCIQDbQ6LRyHZQHKK8JYVT+KhaAgZCzbA8kRs+e4g7hHq9dQIhAIebtz7/szH09K28y8KXbE3FewXTHiFGijjqJbFfjt8C","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":138186},"gitHead":"2fc56f284d551fb0998aa12dc2610da8a2f44fd7","_npmUser":{"name":"mwspace","email":"app@mwspace.com"},"repository":{"url":"git+https://github.com/2sophia/motor.git","type":"git","directory":"skill"},"_npmVersion":"11.13.0","description":"Claude Code skill for the sophia-motor Python library — teaches a developer's Claude how to build agents with sophia-motor (the @tool decorator, MotorConfig, RunTask, subagents, MCP integration, multi-turn chat).","directories":{},"_nodeVersion":"24.11.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sophia-motor-skill_0.5.0_1777904365911_0.6158986238367976","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@2sophia/sophia-motor-skill","version":"0.5.1","description":"Claude Code skill for the sophia-motor Python library — teaches a developer's Claude how to build agents with sophia-motor (the @tool decorator, MotorConfig, RunTask, subagents, MCP integration, multi-turn chat).","keywords":["claude-code","skill","anthropic","claude","agent","agent-sdk","mcp","sophia-motor","ai"],"homepage":"https://github.com/2sophia/skills","repository":{"type":"git","url":"git+https://github.com/2sophia/skills.git","directory":"skills/sophia-motor"},"bugs":{"url":"https://github.com/2sophia/skills/issues"},"author":{"name":"Sophia AI","email":"tech@2sophia.ai"},"license":"MIT","publishConfig":{"access":"public"},"gitHead":"73b2097c2437ecde78d4ce73b6b8afb43d5ef7d9","_id":"@2sophia/sophia-motor-skill@0.5.1","_nodeVersion":"24.11.1","_npmVersion":"11.13.0","dist":{"integrity":"sha512-ao5Ayw1UPeemHeU+qMQ1GNc6JR1auerjbAdQxbD3Aif/OYRC5hLKwOxynnKbWsNKGol5XpL+gVy1Kh+vISPpdA==","shasum":"51ad6fde9c09f17ad00a3223f8ac0e7451517942","tarball":"https://registry.npmjs.org/@2sophia/sophia-motor-skill/-/sophia-motor-skill-0.5.1.tgz","fileCount":19,"unpackedSize":140659,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCI758mN/qLMVYU7yGfFlCb83KwfUkvUMalHsA8bLdR2AIhALLQuE9G1EB9q+qVDJMKxJtcZehgiz0oSzt4ILZx+XBd"}]},"_npmUser":{"name":"mwspace","email":"app@mwspace.com"},"directories":{},"maintainers":[{"name":"mwspace","email":"app@mwspace.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sophia-motor-skill_0.5.1_1777926112271_0.8073402230496665"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T14:19:25.817Z","modified":"2026-05-04T20:21:52.546Z","0.5.0":"2026-05-04T14:19:26.137Z","0.5.1":"2026-05-04T20:21:52.439Z"},"bugs":{"url":"https://github.com/2sophia/skills/issues"},"author":{"name":"Sophia AI","email":"tech@2sophia.ai"},"license":"MIT","homepage":"https://github.com/2sophia/skills","keywords":["claude-code","skill","anthropic","claude","agent","agent-sdk","mcp","sophia-motor","ai"],"repository":{"type":"git","url":"git+https://github.com/2sophia/skills.git","directory":"skills/sophia-motor"},"description":"Claude Code skill for the sophia-motor Python library — teaches a developer's Claude how to build agents with sophia-motor (the @tool decorator, MotorConfig, RunTask, subagents, MCP integration, multi-turn chat).","maintainers":[{"name":"mwspace","email":"app@mwspace.com"}],"readme":"# sophia-motor — Claude Code skill\n\nA meticulous skill that teaches your local [Claude Code](https://docs.claude.com/en/docs/claude-code/) how to build agents with [`sophia-motor`](https://github.com/2sophia/motor) — the `@tool` decorator, `MotorConfig`, `RunTask`, subagents, in-process MCP integration, structured output, and the production patterns the maintainers ship.\n\n## Install (recommended) — via Claude Code marketplace\n\nInside a Claude Code session:\n\n```\n/plugin marketplace add 2sophia/skills\n/plugin install sophia-motor\n```\n\nClaude Code clones the [`2sophia/skills`](https://github.com/2sophia/skills) repo, reads [`.claude-plugin/marketplace.json`](../../.claude-plugin/marketplace.json), and registers the skill. Update later with `/plugin update`. Zero filesystem ceremony.\n\n## Install (alternative) — via npm\n\nIf you prefer npm-driven installs:\n\n```bash\nnpm install -g @2sophia/sophia-motor-skill\nSKILL_DIR=$(npm root -g)/@2sophia/sophia-motor-skill\nmkdir -p ~/.claude/skills && ln -s \"$SKILL_DIR\" ~/.claude/skills/sophia-motor\n```\n\nThe marketplace path is canonical and avoids the symlink dance — prefer it unless you have a specific reason for npm.\n\n## What the skill does\n\nWhen you ask your Claude (in Claude Code) to write Python code that uses `sophia-motor`, it loads `SKILL.md` and follows the conventions documented inside — including the **golden rule**: when uncertain about a field, default, or signature, **read the installed source** of the `sophia-motor` package directly rather than guessing.\n\nThe skill covers:\n\n- Installation, `.env`, first run\n- `Motor` / `MotorConfig` / `RunTask` API + lifecycle + env-var cascade\n- Built-in tools (Read, Glob, Bash, …) + the strict guardrail\n- **`@tool` decorator** + `ToolContext` for Python functions exposed as in-process MCP tools\n- `SKILL.md` mounting (the agent skills feature)\n- Attachments (hard-link / symlink quirks)\n- Structured output (`output_data`) + generated files (`output_files`)\n- Streaming + every chunk type\n- `Chat` + `motor.console()` + `motor.interrupt()`\n- Subagents (inheritance + explicit-restrict patterns)\n- Multi-provider adapters (Anthropic / vLLM / custom)\n- Observability — events, logs, audit dump\n- Production patterns — singleton motor, concurrency, chat backends\n- Reference tables — full field/env-var/event-type lookup\n- 10 known gotchas + recovery recipes\n\n## Versioning\n\nThe skill version tracks the `sophia-motor` Python package version it was built against. `0.5.1` is built against `sophia-motor==0.5.1`. When the installed Python version differs, the skill instructs Claude to inspect the installed source for ground truth — fail-safe by design.\n\n## Update\n\n- Marketplace: `/plugin update` inside Claude Code\n- npm: `npm update -g @2sophia/sophia-motor-skill` (the symlink picks up the new content automatically)\n\n## Uninstall\n\n- Marketplace: `/plugin uninstall sophia-motor`\n- npm:\n  ```bash\n  rm ~/.claude/skills/sophia-motor\n  npm uninstall -g @2sophia/sophia-motor-skill\n  ```\n\n## License\n\nMIT — see [LICENSE](https://github.com/2sophia/motor/blob/main/LICENSE) in the main repo.\n","readmeFilename":"README.md"}