Add ara-sdk skill for skills.sh

[adisinghstudent]

Summary

• Adds skills/ara-sdk/SKILL.md — a skills.sh-compatible skill for the Ara Python SDK.
• Covers ara.Automation, @ara.tool, ara.env / ara.secret, connectors, and the ara deploy / ara run / ara schedule CLI.
• Authored from the current public SDK (ara-sdk 0.1.53), README, and every examples/*.py.

Install-test

https://skills.sh/aradotso/ara-python-sdk/ara-sdk

---

Note

Low Risk
Low risk: adds a new documentation-only skill file with no runtime or behavioral code changes.

Overview
Adds a new skills/ara-sdk/SKILL.md skills.sh skill documenting how to build, deploy, run, and schedule Ara Python SDK automations.

The guide covers ara.Automation, @ara.tool patterns (typed args/schema), secrets/env handling, entrypoint scripts for deps, connector scoping, filesystem persistence, key CLI flags, and troubleshooting/resources.

^{Reviewed by Cursor Bugbot for commit f85c83e. Bugbot is set up for automated code reviews on this repo. Configure here.}

---

Summary by cubic

Adds a skills.sh skill for the Ara Python SDK so developers can build, deploy, run, and schedule automations on Ara quickly. Includes clear examples, CLI usage, connectors, and troubleshooting.

• New Features
  • Adds skills/ara-sdk/SKILL.md with a full skill for ara-sdk.
  • Covers ara.Automation, @ara.tool, ara.env, and ara.secret.
  • Documents CLI flows: ara auth, ara deploy, ara run, ara logs with key flags.
  • Shows connector usage and scoping (skills=[...], allow_connector_tools), e.g., Gmail → iMessage.
  • Includes practical recipes: hello world, entrypoint installs, file persistence, news digest (Exa + Resend).
  • Notes SDK version (ara-sdk==0.1.53), common pitfalls, and troubleshooting.

^{Written for commit f85c83e. Summary will update on new commits.}

[cubic-dev-ai]

3 issues found across 1 file

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="skills/ara-sdk/SKILL.md">

<violation number="1" location="skills/ara-sdk/SKILL.md:29">
P1: This skill is written against an SDK surface that doesn't exist in this repo.</violation>

<violation number="2" location="skills/ara-sdk/SKILL.md:38">
P2: Scheduling is supported in code here, so this guidance sends users to the wrong workflow.</violation>

<violation number="3" location="skills/ara-sdk/SKILL.md:123">
P2: The CLI reference lists flags that the current parser doesn't accept.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}

[cubic-dev-ai]

P1: This skill is written against an SDK surface that doesn't exist in this repo.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At skills/ara-sdk/SKILL.md, line 29:

<comment>This skill is written against an SDK surface that doesn't exist in this repo.</comment>

<file context>
@@ -0,0 +1,523 @@
+
+Two primitives:
+
+1. **`ara.Automation(id, system_instructions=..., tools=[...])`** — the agent declaration. One per file.
+2. **`@ara.tool`** — a Python function the agent can call. Any JSON-serializable return type is fine (`dict`, `list`, `str`, `int`, `float`, `bool`, `None`).
+
</file context>

[cubic-dev-ai]

P2: The CLI reference lists flags that the current parser doesn't accept.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At skills/ara-sdk/SKILL.md, line 123:

<comment>The CLI reference lists flags that the current parser doesn't accept.</comment>

<file context>
@@ -0,0 +1,523 @@
+| Flag | Default | Purpose |
+|---|---|---|
+| `--activate` | `true` | Activate after deploy |
+| `--cron "<expr>"` | — | Set a cron schedule on deploy (e.g. `"0 9 * * *"`) |
+| `--every-seconds N` | — | Set a fixed-interval schedule (mutex with `--cron`) |
+| `--timezone` | `UTC` | Schedule TZ |
</file context>

[cubic-dev-ai]

P2: Scheduling is supported in code here, so this guidance sends users to the wrong workflow.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At skills/ara-sdk/SKILL.md, line 38:

<comment>Scheduling is supported in code here, so this guidance sends users to the wrong workflow.</comment>

<file context>
@@ -0,0 +1,523 @@
+- **Connector tools** — third-party integrations (Gmail, iMessage/`linq_send_message`, Slack, etc.) enabled at app.ara.so/connect. **On by default**; pass `allow_connector_tools=False` to lock down.
+- **SDK custom tools** — the `@ara.tool` Python functions you ship.
+
+Schedules (cron) are configured in the **app.ara.so UI** per automation, *not* in code, to avoid drift. CLI flags `--cron` / `--every-seconds` exist for one-shot setup at deploy time.
+
+---
</file context>