Install:
npx skills add diskd-ai/clarify| skills.sh
Skill for clarifying Redmine tasks by reading the issue, analyzing the relevant codebase, asking targeted questions, and posting a structured design-doc comment back to the task.
This skill orchestrates a task clarification workflow that combines:
- Reading a Redmine issue via the
redmine-cliskill - Analyzing the codebase in the current directory for context
- Asking open-ended clarification questions to surface ambiguities and edge cases
- Verifying that all issue requirements align with the stated objective
- Posting a design-doc comment on the Redmine task via the
design-docskill
Triggers:
- Before starting implementation on a Redmine task that has unclear or incomplete requirements
- When a task needs technical clarification or design discussion
- When you want to produce a structured design comment directly on the issue
Use cases:
- Clarify acceptance criteria before writing code
- Surface missing requirements, ambiguities, or edge cases in a Redmine task
- Generate a technical design document as a Redmine journal comment
- Ensure all stated requirements are addressed and aligned with the objective
/clarify <issue-id>
- A valid Redmine configuration in
~/.red/config.json(server URL + API key) - The current working directory should contain the codebase related to the task
| Step | Action | Details |
|---|---|---|
| 1 | Read the task | Fetch the full Redmine issue (description, status, journals) via redmine-cli |
| 2 | Analyze codebase | Read the current directory to understand context, patterns, and relevance |
| 3 | Ask questions | Surface open-ended clarification questions before writing any comment |
| 4 | Verify coverage | Confirm all issue requirements are addressed and correspond to the objective |
| 5 | Post design doc | Create a Redmine comment with a structured design document via design-doc |
clarify/
SKILL.md # Entry point (workflow definition)
README.md # This file (overview)
| Skill | Install | Purpose |
|---|---|---|
redmine-cli |
npx skills add diskd-ai/redmine-cli | skills.sh |
Read/write Redmine issues, journals, and comments via the REST API |
design-doc |
npx skills add diskd-ai/design-doc | skills.sh |
Generate structured technical design documents (TRD / RFC / spec) |
- Full skill reference: SKILL.md
MIT