the-agency-ai/.claude/skills/preview
.claude/skills/preview/SKILL.md
Preview the current project using the configured infrastructure provider
$ install --global
skillsauthnpx skillsauth add the-agency-ai/the-agency .claude/skills/previewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 7:34 PM31.6s1 file scanned
SKILL.md
- description:
- Preview the current project using the configured infrastructure provider
<!--
Flag #62/#63: allowed-tools removed. Inherits Bash(*) from
.claude/settings.json. Restricting to specific subcommand patterns at the
skill level silently blocks agents on permission prompts the agent cannot
see — see dispatch #171 for the devex incident that surfaced this trap.
-->
Preview
Launch a local or remote preview of the project using the configured infrastructure provider.
Arguments
- $ARGUMENTS: Optional flags:
--status— check current preview status--stop— stop running preview--logs— show preview logs- (default) — start/update preview
How to Execute
Step 1: Resolve Provider
Read the preview provider from claude/config/agency.yaml under preview.provider.
# agency.yaml
preview:
provider: "docker-compose" # or "fly", "vercel", "cloudflare"
The provider maps to a tool: ./claude/tools/preview-{provider}
Step 2: Check Provider Tool Exists
Verify ./claude/tools/preview-{provider} exists and is executable. If not:
- List available preview tools:
ls ./claude/tools/preview-* - Tell the user which providers are available
- Suggest adding the provider tool if none exist
Step 3: Dispatch to Provider
Execute: ./claude/tools/preview-{provider} {verb} {args}
Where verb is one of: start, stop, status, logs (mapped from flags above, default: start).
Step 4: Report
Show the user:
- Preview URL (if started)
- Status (running, stopped, error)
- Any relevant logs or errors
Provider Contract
Each preview-{provider} tool must support these verbs:
start— launch preview, print URL to stdoutstop— tear down previewstatus— print current state (running/stopped/error)logs— stream or print recent logs
Error Handling
- If no provider configured in agency.yaml, suggest adding the
previewsection - If provider tool missing, list available alternatives
- If provider command fails, show stderr and suggest troubleshooting
Related Skills
the-agency-ai/src/claude/skills/worktree-sync
business
VerifiedTrustedCommunity
Sync worktree with master — merge, copy settings, run sandbox-sync, report changes
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-list
tools
VerifiedTrustedCommunity
List all git worktrees with status info (branch, clean/dirty, deps)
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-delete
tools
VerifiedTrustedCommunity
Remove a git worktree and optionally delete its branch
5SKILL.mdUpdated Apr 22, 2026
the-agency-ai/src/claude/skills/worktree-create
development
VerifiedTrustedCommunity
Create a new git worktree with dedicated branch and bootstrapped dev environment
5SKILL.mdUpdated Apr 22, 2026