Skip to content

Add setup skill and rework README deploy docs#1

Open
Jerrydiii wants to merge 1 commit into
mainfrom
setup-skill
Open

Add setup skill and rework README deploy docs#1
Jerrydiii wants to merge 1 commit into
mainfrom
setup-skill

Conversation

@Jerrydiii

Copy link
Copy Markdown
Collaborator

Summary

  • New .agents/skills/setup/SKILL.md: guided, agent-runnable deployment — clones the repo (or reuses an existing clone), creates .env from .env.example, collects credentials, discovers HubSpot/Metabase IDs via their APIs, loads the environment, and runs read-only verification checks against HubSpot, Metabase, and Slack. Safe to re-run to finish a partial setup.
  • README: replaced Setup with How to deploy — leads with a copy-paste agent prompt pointing at the setup skill, keeps the manual steps as a human-readable reference; added the skill to the Skills table and project layout.
  • .env.example: quoted multi-word defaults (PRIMARY_METRIC_LABEL, POC_PIPELINE_LABEL) that previously errored and came through empty under the documented set -a && source .env && set +a loader; documented the quoting rule.

Verification

Ran the skill end-to-end in a clean environment via a fresh agent: real clone, .env creation, env loading, and idempotent re-run were executed; API discovery/verification commands were syntax- and env-var-checked against .env.example and the scripts (no live credentials). Verdict: pass — the .env.example quoting bug and cp -n portability issue found during verification are fixed in this PR.

Conversation: https://app.warp.dev/conversation/6db3c28d-b0f3-4f33-a6b9-b402ccc8c4b9

Co-Authored-By: Oz oz-agent@warp.dev

- New .agents/skills/setup/SKILL.md: guided deployment (clone or reuse an
  existing clone, create .env, discover HubSpot/Metabase IDs via API,
  load env, read-only verification), verified end-to-end in a clean
  environment by an agent run
- README: replace Setup with How to deploy (copy-paste agent prompt +
  manual reference), add setup skill to Skills table and project layout
- .env.example: quote multi-word defaults (PRIMARY_METRIC_LABEL,
  POC_PIPELINE_LABEL) that previously broke and emptied under
  'set -a && source .env && set +a'; document quoting rule

Co-Authored-By: Oz <oz-agent@warp.dev>
@Jerrydiii
Jerrydiii requested a review from dplakon July 16, 2026 21:58
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.

1 participant