Skip to content

Update the Verify skill authoring guide#102

Open
simsinght wants to merge 1 commit into
mainfrom
verify-skill-authoring-docs
Open

Update the Verify skill authoring guide#102
simsinght wants to merge 1 commit into
mainfrom
verify-skill-authoring-docs

Conversation

@simsinght

@simsinght simsinght commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Expands the Verify skill authoring guide and the preview YAML reference.

Changes

  • Where skills live.aviator/verify/skills/, one skill per .md file; verify_skill_files to point a preview at files elsewhere in the repo.
  • Credentials — reference account secrets with {{ secrets.<name> }} placeholders, substituted when the field is filled and kept out of plans and transcripts; clarified how this differs from the preview's secrets: environment variables.
  • What's observable — guidance on telling Verify what the preview can and can't exercise, so scenarios target things the running app can actually show.
  • Frontmatter description — optional per-file summary used to surface the relevant skills.
  • Added verify_skill_files to the Preview YAML reference; retitled the page "Writing a Verify skill".

@simsinght simsinght changed the title Correct Verify skill authoring docs to shipped behavior Update the Verify skill authoring guide Jun 17, 2026
@simsinght simsinght force-pushed the verify-skill-authoring-docs branch 2 times, most recently from 41de725 to d5441ec Compare June 18, 2026 02:02
Expands the skill how-to and preview YAML reference: where skill files live (.aviator/verify/skills/, one skill per file; verify_skill_files to point a preview at files elsewhere), referencing credentials via {{ secrets.<name> }} placeholders, declaring what the preview can exercise, and an optional frontmatter description. Retitles the page 'Writing a Verify skill'.
@simsinght simsinght force-pushed the verify-skill-authoring-docs branch from d5441ec to cece89b Compare June 18, 2026 02:06
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