[DRAFT] Feature - specification helper skills#8
Open
petrixh wants to merge 2 commits into
Open
Conversation
Skills for managing project specifications via slash commands: - spec-status: check spec completeness and recommend next steps - spec-validate: cross-check specs for consistency errors and gaps - spec-generate: generate data model, use cases, and checklists - spec-architect: propose updates to architecture.md - spec-interview: interactively fill in project-context.md via Q&A Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Skills now discover spec structure from the filesystem instead of hardcoding section numbers, file paths, and project-specific details. Also fix frontmatter: remove unsupported allowed-tools, rename user-invocable to user-invokable. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
petrixh
force-pushed
the
feature/spec-skills
branch
from
8cf8d6c to
9d6b484
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
[DRAFT] Might need some more validation/tweaking before it's good to go.. And before it's "good" need to read through the skills with a bit more thought. However, testing and feedback is encouraged :)
This pull request introduces five new skill definitions to the
.claude/skillsdirectory, each focused on a specific aspect of the specification workflow. These skills are designed to guide users through spec creation, interview-driven completion, architecture updates, completeness diagnostics, and validation checks, with clear rules and step-by-step instructions. The skills emphasize placeholder detection, guardrail respect, and workflow-driven recommendations.New skill definitions added:
Spec document creation and completion:
.claude/skills/spec-interview/SKILL.md: Adds an interactive Q&A-driven skill for filling in spec documents by replacing placeholders, with support for targeting specific files or sections and preserving user-added content..claude/skills/spec-generate/SKILL.md: Introduces a skill for generating downstream spec artifacts (data model, use cases, verification checklists) based on filled-in context and architecture, following templates and workflow order.Architecture and completeness management:
.claude/skills/spec-architect/SKILL.md: Defines a guardrailed skill for proposing and applying updates to the architecture spec, identifying and filling placeholders based on actual project context and dependencies, with explicit user approval required before changes..claude/skills/spec-status/SKILL.md: Adds a read-only skill for assessing spec file completeness, classifying files as empty, partial, complete, or template, and recommending next workflow steps.Validation and consistency checking:
.claude/skills/spec-validate/SKILL.md: Provides a skill for cross-checking all spec files for consistency, completeness, and structural correctness, reporting errors, warnings, and info, and optionally auto-fixing clear structural gaps when requested.