https://github.com/scottconverse/scottdevskills-suite
https://github.com/scottconverse/scottdevskills-suite
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/scottconverse/scottdevskills-suite
- Owner: scottconverse
- License: other
- Created: 2026-06-13T03:13:41.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-13T04:22:48.000Z (about 1 month ago)
- Last Synced: 2026-06-13T05:25:17.469Z (about 1 month ago)
- Language: Python
- Size: 251 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ScottDevSkills
ScottDevSkills is a Codex plugin for serious development work: audits,
interface walkthroughs, pipeline runs, prompt quality checks, context control,
and optional gate templates.
Version: **v0.1b**
The plugin is built for developers who want fewer vague reviews and more
evidence: findings tied to files, runtime behavior, tests, screenshots, logs,
manifests, and concrete next actions.
## What It Includes
- **Audit Lite**: fast review of a small fix or scoped diff.
- **Audit Full**: deep release/readiness audit across code, UX, docs, tests,
and QA behavior.
- **Walkthrough**: browser-driven UI wiring review for finished or nearly
finished frontends.
- **Agent Pipeline**: manifest-driven project execution with initialization,
intake, new-run setup, validation, execution, and status inspection.
- **Prompt Quality**: prompt linting, regression case design, eval planning,
and release checks for prompt changes.
- **Context Discipline**: long-session hygiene, large-output control,
handoffs, and careful pre-edit analysis.
- **Hardgate Templates**: inert templates for enforcement gates and policy
checks.
## Installation
ScottDevSkills is distributed as a Codex marketplace repository.
### Install From Codex
1. Open the Codex plugin marketplace flow.
2. Add or refresh the marketplace repository `scottconverse/scottdevskills-suite`.
3. Install the plugin named `scott-dev-skills`.
4. Start a fresh Codex thread so the newly installed skills are loaded into the
session.
### Install From The CLI
For a first-time install, add the marketplace and then install the plugin:
```powershell
codex plugin marketplace add scottconverse/scottdevskills-suite --ref main --sparse .agents/plugins/marketplace.json --sparse plugins/scott-dev-skills
codex plugin add scott-dev-skills@scottdevskills
```
If the `scottdevskills` marketplace is already configured, refresh it before
installing. Use this path when the plugin is not currently installed. Codex
installs from its local marketplace snapshot, not directly from GitHub on every
install:
```powershell
codex plugin marketplace upgrade scottdevskills
codex plugin add scott-dev-skills@scottdevskills
```
If the plugin is already installed and you want to update or reinstall it,
remove the installed copy before refreshing the marketplace:
```powershell
codex plugin remove scott-dev-skills@scottdevskills
codex plugin marketplace upgrade scottdevskills
codex plugin add scott-dev-skills@scottdevskills
```
### Troubleshooting
- If Codex does not show the new skills immediately, start a fresh Codex
thread.
- If the CLI says the marketplace is already configured and the plugin is not
installed, refresh the marketplace first, then install the plugin.
- If the plugin is already installed, remove it before refreshing and
reinstalling. This avoids stale cache and cache-backup permission failures.
- The plugin id is `scott-dev-skills@scottdevskills`.
## Documentation
- [Manual](docs/manual.md)
- [Landing Page](https://scottconverse.github.io/scottdevskills-suite/)
## Repository Layout
- `.agents/plugins/marketplace.json`: Codex marketplace metadata.
- `plugins/scott-dev-skills`: installable plugin package.
- `plugins/scott-dev-skills/skills`: skill entrypoints.
- `plugins/scott-dev-skills/references`: shared quality gates and contracts.
- `plugins/scott-dev-skills/tests/skill-regression`: trigger regression cases.
- `docs`: public documentation and landing page.
## Status
ScottDevSkills v0.1b is an early beta. The plugin is installable and validated,
but the skill suite is expected to evolve as real projects expose sharper
workflow boundaries and better regression cases.