Skip to content

docs: add AGENTS.md with Cursor Cloud dev environment setup notes - #121

Draft
nieblara wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-6a9a
Draft

docs: add AGENTS.md with Cursor Cloud dev environment setup notes#121
nieblara wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-6a9a

Conversation

@nieblara

Copy link
Copy Markdown
Contributor

Summary

  • Sets up and documents the local dev environment for this agent-skills repo (no deployable app; skills + Promptfoo eval suite + Python validation tooling).
  • Adds AGENTS.md with a ## Cursor Cloud specific instructions section capturing two non-obvious gotchas for running the LLM evals: (1) the default /exec-daemon/node (v22.14.0) is too old for Promptfoo which needs >=22.22.0 (use the nvm-installed Node 22), and (2) ANTHROPIC_API_KEY is required for npm run eval.
  • No product code changed.

Testing

  • Manual (describe below)

Ran the CI-equivalent checks (all pass, no secrets needed):

  • python3 scripts/validate_skills.py -> Validated 48 SKILL.md files successfully.
  • python3 -m unittest discover -s tests -> Ran 8 tests, OK.
  • python3 scripts/generate_catalog.py --check -> skills.json is up to date.
  • npm test --prefix evals -> 90 pass / 0 fail.
  • npm run eval:flag-command:single (with nvm Node 22) -> harness loads the skill and launches the provider, erroring only on the unset ANTHROPIC_API_KEY, confirming end-to-end wiring up to the API boundary.

Notes

  • The full LLM eval suite (npm run eval) is blocked only on a missing ANTHROPIC_API_KEY secret; everything else runs locally.
  • Update script (dependency refresh on VM startup): npm ci --legacy-peer-deps --prefix evals and npm ci --legacy-peer-deps --prefix tests. Python tooling is stdlib-only.
Open in Web Open in Cursor 

Co-authored-by: Ramon Niebla <nieblara@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown

Skill eval results

Skill Before After Δ
agentcontrol/configs-create 100/100 (4/4) 100/100 (4/4) no change
agentcontrol/configs-update 80/100 (4/5) 80/100 (4/5) no change
agentcontrol/configs-variations 80/100 (4/5) 80/100 (4/5) no change
agentcontrol/tools 75/100 (3/4) 75/100 (3/4) no change
feature-flags/flag-and-release-change - 100/100 (4/4) new
feature-flags/flag-release - 100/100 (5/5) new
feature-flags/launchdarkly-flag-command - 100/100 (3/3) new
feature-flags/launchdarkly-flag-create 100/100 (3/3) 100/100 (4/4) no change
feature-flags/should-flag-change - 100/100 (10/10) new

Only suites whose source actually changed since their last recorded score were re-run. Soft-failing while we stabilise the baseline.

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