Skip to content

fix: address structural and quality gaps from project review#23

Merged
felipecabargas merged 7 commits into
mainfrom
fix/review-findings
May 21, 2026
Merged

fix: address structural and quality gaps from project review#23
felipecabargas merged 7 commits into
mainfrom
fix/review-findings

Conversation

@felipecabargas
Copy link
Copy Markdown
Owner

Summary

  • competitive-analysis: adds `WebFetch` to `allowed-tools` and a new Step 1.5 that fetches competitor homepages and pricing pages before building profiles — analysis is now grounded in live public data rather than relying entirely on user recall
  • validate-skill.sh: replaces a loose `## How` grep (effectively always matched) with three targeted section checks — trigger, output, and process — so the validator now surfaces real gaps in `prioritize`, `sprint-review`, and `write-product-strategy`
  • CI: new `validate.yml` workflow runs `validate-skill.sh` on every push and PR; validation is also added as a gate in `release.yml` before packaging
  • release.yml: zip artifact now includes `agents/` alongside `skills/`, renamed from `gambit-skills-$version` to `gambit-$version` to reflect full content
  • skill-framework.md: removed stale "Future Directions" section that listed agents as future work when they already ship
  • contributing.md: removed reference to a non-existent CONTRIBUTORS file

Why

Identified during a structural and value review of the project. The main issues were: competitive-analysis couldn't actually research competitors without web access; the validator produced no real signal; agents were silently excluded from the release artifact; and two docs contained stale or incorrect content.

Reviewer notes

  • The validator will now flag `prioritize`, `sprint-review`, and `write-product-strategy` with warnings for missing trigger/output sections — those are legitimate gaps worth a follow-up, intentionally left as warnings (not errors) so they don't block CI.
  • The competitive-analysis Step 1.5 uses `WebFetch` to fetch homepage and `/pricing` paths; if a URL 404s it falls back gracefully and marks the rating as Assumed confidence.

🤖 Generated with Claude Code

felipecabargas and others added 6 commits May 21, 2026 02:12
- competitive-analysis: add WebFetch to allowed-tools and Step 1.5 to
  fetch competitor homepages and pricing pages before building profiles,
  so analysis is grounded in live public data rather than user recall

- validate-skill.sh: replace loose '## How' grep with three targeted
  checks (trigger section, output section, process section) — now
  correctly flags prioritize, sprint-review, and write-product-strategy
  for missing structural sections

- ci: add validate.yml workflow that runs validate-skill.sh on every
  push and PR; add validation as a release gate in release.yml before
  packaging

- release.yml: include agents/ in the zip artifact alongside skills/;
  rename artifact from gambit-skills-$version to gambit-$version to
  reflect full content

- skill-framework.md: remove stale 'Future Directions' section that
  listed agents as future work when they already exist

- contributing.md: remove reference to non-existent CONTRIBUTORS file

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…-review

Both skills were flagged by validate-skill.sh for missing structural
sections. Fixes:

- prioritize: rename '## Step 3: Output' → '## Output Format' so the
  validator can locate it; add '## How to Trigger' with natural language
  phrase examples including the Agentic RICE use case

- sprint-review: add '## Output Format' (summary of the 7-section
  report structure) and '## How to Trigger' with phrase examples;
  all content is additive — no existing text changed

All 13 skills now pass validate-skill.sh with no warnings.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace Claude-specific language in all How to Trigger sections:
- "Ask Claude to" → "Ask your assistant to"
- "Claude will automatically invoke this skill" → "This skill will automatically"

Affects all 12 skills that have a trigger section. No logic or
behavior changed — phrasing only.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Rename references/gemini-tools.md → references/antigravity-tools.md;
  update content to say "Antigravity CLI" throughout
- Update GEMINI.md @-include to point to renamed tool mapping file
- Update README.md: section header and install/update commands
  (gemini → agy)

gemini-extension.json and GEMINI.md filenames are unchanged — agy
still uses both formats.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
agent SKILL.md files were nested in subdirectories (agents/<name>/SKILL.md),
which is not the format expected by Claude Code or Gemini/agy. Both
platforms expect agent definitions as flat .md files directly in agents/.

Changes:
- agents/<name>/SKILL.md → agents/<name>.md for all four agents
- validate.yml: remove agents/*/SKILL.md from CI glob (agents are no
  longer SKILL.md format and don't need skill validation)
- docs/getting-started.md: update manual install snippet to wrap each
  flat agent .md into the ~/.claude/skills/<name>/SKILL.md structure
  that Claude Code expects for manual installs
- README.md: update directory tree

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@felipecabargas felipecabargas marked this pull request as ready for review May 21, 2026 01:03
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@felipecabargas felipecabargas merged commit 4d1cc61 into main May 21, 2026
2 checks passed
@felipecabargas felipecabargas deleted the fix/review-findings branch May 21, 2026 01:05
@felipecabargas felipecabargas self-assigned this May 21, 2026
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