@andreprado/agentkit 0.1.0-alpha.16 → 0.1.0-alpha.17

package/src/templates/skills/agentkit-integrations/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: agentkit-integrations
+description: Use when adding, inspecting, connecting, or troubleshooting AgentKit-managed integrations such as managed Composio in an Agent Capsule.
+---
+
+# AgentKit Integrations
+
+Use this when the owner asks for managed connected apps, Gmail/Calendar/Slack/Linear through AgentKit, or paid AgentKit-managed Composio.
+
+## Managed Composio
+
+Managed Composio is a paid hosted AgentKit feature. Use it when the owner wants AgentKit to manage OAuth/connect links, per-agent connected app state, deploy readiness, and hosted Composio credentials.
+
+Use BYO `defineTool` instead when the owner wants to bring their own Composio account/API key.
+
+## Config
+
+Edit `agentkit.config.ts`:
+
+```ts
+import { composioManaged, defineAgent } from "@andreprado/agentkit";
+
+export default defineAgent({
+  integrations: [
+    composioManaged({
+      toolkits: ["gmail", "googlecalendar"],
+      tools: {
+        gmail: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"],
+        googlecalendar: ["GOOGLECALENDAR_CREATE_EVENT"],
+      },
+    }),
+  ],
+});
+```
+
+Keep the action list explicit. Do not expose the whole Composio catalog by default.
+
+## Commands
+
+```sh
+npm run agentkit -- inspect
+npm run agentkit -- deploy doctor
+npm run agentkit -- deploy
+npm run agentkit -- integrations status
+npm run agentkit -- integrations connect composio --toolkit gmail
+```
+
+## Rules
+
+- Do not add `COMPOSIO_API_KEY` to `.env.schema` for managed Composio.
+- Do not ask the owner for a Composio key when using managed Composio.
+- Managed Composio requires a non-anonymous hosted deploy and `managed_composio` entitlement.
+- The generated tool is `agentkit_composio_execute`.
+- Use one Composio settings profile per agent.
+
+## Verification
+
+Expected `inspect` output includes:
+
+```txt
+integrations[0].provider = composio
+tools includes agentkit_composio_execute
+managedSecrets includes COMPOSIO_API_KEY
+```
+
+If `deploy doctor` reports `managed_composio_entitlement_required`, the owner must log in with a paid AgentKit Cloud account or ask an operator to grant it.

package/src/templates/skills/agentkit-troubleshooting/SKILL.md

@@ -18,6 +18,7 @@ Use this when something fails.
 
 ```sh
 npm run agentkit -- inspect
+npm run agentkit -- skills status
 npm run typecheck
 npm run agentkit -- env list
 git status --short
@@ -48,5 +49,5 @@ npm run agentkit -- deploy doctor
 - provider not chosen: stay on `test/fake` or ask the owner;
 - schema missing: run `db migrate` and check `schema.sql`;
 - tool validation failed: check `inputSchema` and `outputSchema`;
-- channel secret missing: set hosted managed secret, not source files.
-
+- channel secret missing: set hosted managed secret, not source files;
+- local AgentKit skills are stale: run `npm run agentkit -- skills sync`.