GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — feat(tooling): enforce docs freshness and modernize agent skills by j15z · Pull Request #6756 · simstudioai/sim

Conversation

@j15z

@j15z j15z commented Aug 16, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Summary

  • Add a read-only docs:check mode that detects stale generated integration docs and run it through the existing check:audits CI gate.
  • Preserve final-output comparison for trigger-owned pages and regenerate the five pages already stale on staging.
  • Keep .agents/skills/<name>/SKILL.md as the canonical skill source, expose complete skill directories to Claude through generated .claude/skills/<name> symlinks, and let Cursor discover .agents/skills directly.
  • Remove all 36 deprecated .claude/commands projections, all 36 deprecated .cursor/commands projections, and the stale duplicate Cursor add-hosted-key skill.
  • Update skill syncing, pre-commit behavior, contributor guidance, and integration-authoring skills for the new layout; rename skills:check to check:skills so the existing CI audit runner discovers it automatically and continues rejecting stale Claude links or reintroduced command projections.

This prevents generated docs and agent-specific skill copies from silently drifting away from their canonical sources.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation
  • Other: Developer tooling

Testing

  • bun run agent-stream-docs:generate
  • bun run skills:sync
  • bun run lint
  • bun run apps/sim/scripts/check-block-registry.ts origin/staging
  • bun run check:audits (28 audits, including docs:check and check:skills)
  • bun run check:skills
  • git diff --check

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

Not applicable; this PR only changes developer tooling, generated documentation, and agent configuration.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
greptile-apps[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction
@j15z
j15z requested a review from a team as a code owner August 16, 2026 00:22
@vercel

vercel Bot commented Aug 16, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 16, 2026 1:56am

Request Review
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@cursor

cursor Bot commented Aug 16, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown

PR Summary

Low Risk
Changes are contributor docs, agent command removals, and CI-adjacent skill checklists; no runtime product code in the shown diff.

Overview
Integration authoring skills now treat generated integration docs as a CI gate: run bun run docs:check after generate-docs and integration-catalog:check, and add checklist items so stale .mdx fails in check:audits.

Regeneration policy flipped in validate-integration and related skills: contributors must commit the full generator diff, including catch-up pages from earlier PRs that skipped regen — reverting swept-in hunks as "unrelated drift" is documented as breaking docs:check.

Agent skill layout cleanup: large deprecated .claude/commands/* projections (e.g. add-block, add-integration, add-tools) are deleted from the diff; canonical guidance stays under .agents/skills/*/SKILL.md (the PR description also covers skills:sync, check:skills, and symlinked .claude/skills — not all of that appears in this diff hunk set).

Reviewed by Cursor Bugbot for commit 3ce4b6c. Bugbot is set up for automated code reviews on this repo. Configure here.
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@greptile-apps

greptile-apps Bot commented Aug 16, 2026 •
edited
Loading

Uh oh!

There was an error while loading. Please reload this page.

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR adds read-only generated-documentation freshness enforcement and migrates agent integrations from copied command projections to canonical skill directories.

  • Adds docs:check and includes generated-documentation verification in the audit suite.
  • Replaces Claude command copies with generated skill-directory symlinks while allowing Cursor to consume canonical skills directly.
  • Removes deprecated projections, refreshes stale integration documentation, and updates contributor and skill guidance.

Confidence Score: 5/5

The PR appears safe to merge because no blocking failure remains within the eligible follow-up review scope.

No blocking failure remains.

Important Files Changed
Filename Overview
scripts/generate-docs.ts Adds an in-memory overlay and final-output comparison so CI can detect stale generated documentation without mutating the checkout.
scripts/sync-skills.ts Replaces copied command projections with Claude directory symlinks and introduces validation and cleanup for generated skill surfaces.
scripts/run-audits.ts Adds documentation freshness checking while renamed check:skills remains covered through automatic check:* discovery.
package.json Exposes the new documentation and skill checks through repository scripts.
.husky/pre-commit Updates canonical-skill synchronization to stage generated Claude skill links.
.github/CONTRIBUTING.md Documents the canonical skill directory and the current Claude and Cursor discovery model.

Flowchart

 
%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Canonical[".agents/skills/name/"] --> Cursor["Cursor direct discovery"]
  Canonical --> Sync["scripts/sync-skills.ts"]
  Sync --> Claude[".claude/skills/name symlink"]
  Sources["Blocks, tools, and triggers"] --> Generator["scripts/generate-docs.ts"]
  Generator --> Docs["Generated integration docs"]
  Audits["check:audits"] --> SkillCheck["check:skills"]
  Audits --> DocsCheck["docs:check"]
  SkillCheck --> Claude
  DocsCheck --> Docs
Loading

Reviews (5): Last reviewed commit: "fix(skills): clean orphaned Claude proje..." | Re-trigger Greptile
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
cursor[bot]
cursor Bot reviewed Aug 16, 2026
View reviewed changes
Comment thread scripts/generate-docs.ts Resolved

Uh oh!

There was an error while loading. Please reload this page.
@vercel
vercel Bot deployed to Preview August 16, 2026 00:28
View deployment
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@greptile
greptile-apps[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@cursor review
cursor[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
cursor[bot]
cursor Bot reviewed Aug 16, 2026
View reviewed changes

@cursor cursor Bot left a comment

Copy link
Copy Markdown

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 36e2316. Configure here.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@vercel
vercel Bot deployed to Preview August 16, 2026 01:00
View deployment
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@greptile
greptile-apps[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@cursor review
cursor[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
cursor[bot]
cursor Bot reviewed Aug 16, 2026
View reviewed changes

@cursor cursor Bot left a comment

Copy link
Copy Markdown

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit ccedbb2. Configure here.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@vercel
vercel Bot deployed to Preview August 16, 2026 01:09
View deployment
j15z added 4 commits August 15, 2026 18:40
@j15z
feat(docs): fail CI when generated integration docs are stale
c986794
@j15z
fix(docs): don't flag delete-then-recreated trigger pages in check mode
a6b0600
@j15z
docs(skills): require docs:check in the integration authoring skills
3eeccf5
@j15z
chore(skills): migrate agent commands to native skills
8491532
@j15z
j15z force-pushed the feat/docs-drift-check branch from ccedbb2 to 8491532 Compare August 16, 2026 01:42
@j15z j15z changed the title feat(docs): fail CI when generated integration docs are stale feat(tooling): enforce docs freshness and modernize agent skills Aug 16, 2026
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@greptile
greptile-apps[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@cursor review
All reactions

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
cursor[bot]
cursor Bot reviewed Aug 16, 2026
View reviewed changes
Comment thread scripts/sync-skills.ts Resolved

Uh oh!

There was an error while loading. Please reload this page.
@vercel
vercel Bot deployed to Preview August 16, 2026 01:48
View deployment
@j15z
fix(skills): clean orphaned Claude projections
3ce4b6c
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@greptile
greptile-apps[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
@j15z

j15z commented Aug 16, 2026

Copy link
Copy Markdown
Contributor Author

@cursor review
cursor[bot] reacted with thumbs up emoji
All reactions
  • 👍 1 reaction

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
cursor[bot]
cursor Bot reviewed Aug 16, 2026
View reviewed changes

@cursor cursor Bot left a comment

Copy link
Copy Markdown

There was a problem hiding this comment.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 3ce4b6c. Configure here.

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.
All reactions
@vercel
vercel Bot deployed to Preview August 16, 2026 01:56
View deployment
waleedlatif1
waleedlatif1 approved these changes Aug 16, 2026
View reviewed changes
@waleedlatif1
waleedlatif1 merged commit 7f936dc into staging Aug 16, 2026
31 checks passed

Uh oh!

There was an error while loading. Please reload this page.
@waleedlatif1
waleedlatif1 deleted the feat/docs-drift-check branch August 16, 2026 02:08
@waleedlatif1 waleedlatif1 mentioned this pull request Aug 16, 2026
v0.8.3: sim cli, new tools, credential groups, splunk, finder-like files refactor, security hardening #6765
Merged

This branch was successfully deployed

1 active deployment
Preview — 3ce4b6c9 Deployed Aug 16, 2026 by vercel[bot]
View deployment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@cursor cursor[bot] cursor[bot] left review comments
@waleedlatif1 waleedlatif1 waleedlatif1 approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

2 participants

@j15z @waleedlatif1
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.