# Wikispec Propose

> ---

- Skill: `christianb93/wikispec-propose` (Agent Skill)
- Install (CLI): `npx skillmds@latest add christianb93/wikispec-propose`
- Raw SKILL.md: https://api.skillmd.com/api/skills/christianb93/wikispec-propose/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: christianb93 (https://skillmd.com/u/christianb93)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/christianb93/wikispec-propose

---

--- 
name: wikispec-propose
description: Create specs and designs for a new change. Use this when you need to specify a new change or continue to work on the specification of an existing change.
--- 


# Skill: wikispec-propose

Drive the agent through the full `propose` step for a wikispec change. You will use the `wikispec` tool which is a binary in the path, no need to install anything.

## Steps

1. **Determine the change name.**
   - If the user provided a change name, use it exactly.
   - If no name was provided, but the user has provided a description of what to change, propose a short kebab-case name that captures the user's intent (e.g., `add-auth`, `fix-export-bug`)
   - If no name is provided and no description is provided, assume that we will resume work on an existing active change. Use `wikispec list` to list all active changes. If there is only one name, assume that we will be working on this one, otherwise ask the user. Then skip step 2 (creation of the change) and proceed directly to step 3.

2. **Create the change.**
   Run:
   ```
   wikispec create --change <name>
   ```
   - If the command succeeds, proceed to step 3.
   - If the command fails because the change already exists, derive an alternative name (e.g., append `-2`) and retry this step.

3. **Gather context**
   - load the `wikispec-wiki` skill to understand how to operate the knowledge wiki
   - locate and read the wikis `index.md` file. Check whether any of the pages listed there are relevant for the functionality proposed by the user and read those pages.
   - run `wikispec files --change <name>`  to see whether there are already any specification files for this change, if yes read them

4. **Follow instructions in a loop.**
   Repeat until the step is complete:
   ```
   wikispec instructions --change <name> --step propose
   ```
   - If the output contains instructions, follow them, then call the command again.
   - If the output signals that the step is already complete, stop looping, inform the user that the propose step is complete and suggest to run `/wikispec-plan` next.