ss-workflow-audit

Audit Sublime-Skills projects for install, bootstrap, and convention integrity.

Updated May 19, 2026
One-click install
npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-workflow-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ss-workflow-audit
Source: https://github.com/Emrebener/Sublime-Skills/tree/main/skills/workflow/ss-workflow-audit
Command: npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-workflow-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ss-workflow-audit prevents wasted time by checking whether a Sublime-Skills project is properly installed, bootstrapped, and internally consistent before you run any stages.

Core Features & Use Cases

  • Read-only readiness audit: Runs a suite of deterministic checks and reports PASS/FAIL/WARN/INFO/N/A without modifying files.
  • Framework and git integrity checks: Validates environment variables, presence of required tooling, and basic git repo state to avoid running in an unsupported context.
  • Bootstrap and conventions verification: Confirms .sublime-skills/config.yml presence and validator success, checks gitignore coverage for state.json, verifies SDD artifact directories, and audits configured convention/context files and optional memory setup.
  • Use cases: Ideal before onboarding a new project, before executing an SDD pipeline, after pulling changes from teammates, or when an agent fails due to missing or misconfigured framework artifacts.

Quick Start

Use ss-workflow-audit to produce a complete readiness report and an overall READY / READY-WITH-WARNINGS / NOT READY verdict for the current repository.

Frequently Asked Questions about ss-workflow-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a preflight readiness audit for a spec-driven-development project?

A preflight readiness audit verifies your spec-driven-development project configuration, git integrity, and artifact directories without modifying files. It checks environment variables, config validation, and state.json gitignore coverage to produce a READY or NOT READY verdict before pipeline execution.

What does a Sublime-Skills workflow validation check include?

Sublime-Skills workflow validation includes read-only checks for SUBLIME_SKILLS_HOME, git context, config.yml presence, gitignore correctness for state.json, and SDD artifact directories. It reports PASS, FAIL, WARN, or INFO for each convention and tooling readiness check.

Why does my agent fail due to missing or misconfigured framework artifacts after pulling changes?

Missing or misconfigured framework artifacts cause agent failures when required SDD directories or config.yml are absent after pulling changes. A read-only readiness audit detects these inconsistencies by verifying bootstrap conventions and environment setup before stage execution.

Can I verify git integrity and environment configuration before running SDD pipeline stages?

You can verify git integrity and environment configuration before running SDD pipeline stages using a deterministic readiness audit. It validates SUBLIME_SKILLS_HOME, basic git repo state, and required tooling presence to ensure the context supports safe stage execution across teams.

When do I need to check state.json gitignore coverage in a Sublime-Skills project?

You need to check state.json gitignore coverage when onboarding a new project or after pulling teammate changes to prevent committing local state. The audit confirms gitignore correctly excludes state.json alongside verifying SDD artifact directories and config validation.

Does the readiness audit modify project files during the workflow validation?

The readiness audit does not modify project files during workflow validation. It runs a suite of read-only checks that report framework, git, and convention integrity status, producing a complete readiness report with an overall READY, READY-WITH-WARNINGS, or NOT READY verdict.