academic-writing
Write or revise thesis and paper prose section by section (abstract, introduction, related work, method, results, discussion, conclusion) with the conventions…
Structure a thesis whose contribution is a built artifact (tool, system, method, model) using design science research: explicit problem and requirements, knowledge base, iterative build with design decisions recorded, and a rigorous evaluation strategy (technical benchmarks,
$ npx -y skills add KhaledSaeed18/dotclaude --skill design-science-methodology --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/design-science-methodologyContext preview
The summary Claude sees to decide when to auto-load this skill.
Structure a thesis whose contribution is a built artifact (tool, system, method, model) using design science research: explicit problem and requirements, knowledge base, iterative build with design decisions recorded, and a rigorous evaluation strategy (technical benchmarks,
name: design-science-methodology description: "Structure a thesis whose contribution is a built artifact (tool, system, method, model) using design science research: explicit problem and requirements, knowledge base, iterative build with design decisions recorded, and a rigorous evaluation strategy (technical benchmarks, controlled use, case study, expert review) that separates whether it works from whether it helps, following Hevner's guidelines and Peffers' process. Use when the thesis builds something, when a supervisor says a system alone is not a contribution, or when the evaluation chapter has no design." argument-hint: "(optional) the artifact, the problem it addresses, and the intended users"
Building a system is engineering; showing what is learned from building it is research. Design science research (DSR) is the frame that turns the first into the second: an artifact designed to solve a stated problem, evaluated with rigour, and a contribution to knowledge stated separately from the artifact itself.
1. **Problem identification and motivation**: the problem, who has it, why existing solutions fall short (from `lit-review-synthesis`), and why solving it matters. Concrete and, where possible, quantified. 2. **Objectives of the solution**: requirements the artifact must meet, derived from the problem and the literature. Functional (must do X) and quality (latency under Y, usable by Z without training). Each requirement is later a row in the evaluation table. Number them (R1..Rn). 3. **Design and development**: the artifact, with its design decisions recorded as they are made (`adr-writing` works for this) and the knowledge they draw on (which theories, patterns, prior systems). The thesis describes architecture and the decisions, not every line. 4. **Demonstration**: the artifact used to solve an instance of the problem (a worked example, a pilot). Shows feasibility. 5. **Evaluation**: how well the artifact meets the objectives, with a method chosen from the strategy below. This is the chapter examiners read hardest. 6. **Communication**: the thesis, and the artifact released with documentation (`experiment-reproducibility`).
Iterate: evaluation feeds back into design. Record each cycle; a thesis that shows two design iterations with evidence is stronger than one that presents a finished system.
Choose along two axes (Venable, Pries-Heje, Baskerville): artificial or naturalistic setting, and formative (during design) or summative (final). Combine at least two of:
| Method | Answers | Setting | | --- | --- | --- | | Technical experiment / benchmark | Does it perform (speed, accuracy, scale) against baselines? | artificial | | Controlled experiment with users | Does it help people do the task better than the alternative? | artificial | | Case study in a real setting | Does it work in practice, and what happens around it? | naturalistic | | Expert evaluation / walkthrough | Do practitioners judge it sound and useful? | either | | Illustrative scenario | Can it handle the representative cases? (weak alone) | artificial | | Analytical (complexity, formal properties) | Does it have the guaranteed properties claimed? | artificial |
Map every requirement to at least one method. A requirement with no evaluation is a claim.
Separate two questions in the write-up: *does it work* (efficacy: technical evaluation) and *does it help* (effectiveness: users, context). A master's thesis usually shows the first rigorously and the second in a limited pilot; say which is which.
State which the thesis makes:
Write the design principles explicitly, each with the evidence from the evaluation that supports it. That list is the research contribution; the code is the artifact.
1. The artifact is described precisely enough to be reconstructed. 2. The problem is relevant to a named stakeholder group. 3. The evaluation method fits the artifact and the objectives. 4. The contribution to knowledge is stated apart from the artifact. 5. The design draws on the knowledge base (cite the theories and prior systems it builds on) and the evaluation uses recognised methods. 6. The search for the design is described: alternatives considered, why this one. 7. The thesis communicates to both technical and managerial readers (architecture for the first, requirements and results for the second).
A method chapter skeleton with the six process steps as sections, the requirements table (id, requirement, source, evaluation method), the evaluation design per method (using `research-methodology` for the user-facing ones and `benchmark-reporting` for technical ones), and a placeholder design-principles list to be filled from the evaluation. Update `research/QUESTION.md` with the chosen contribution level.
Reusable Claude Code extension registry. skills, subagents, slash commands, and hooks for engineering, git, testing, and security workflows. Distributed as a shadcn GitHub registry and as installable plugins.
Write or revise thesis and paper prose section by section (abstract, introduction, related work, method, results, discussion, conclusion) with the conventions…
Report computational benchmarks and experimental comparisons the way examiners and reviewers expect: fair baselines run under the same conditions, multiple…
Maintain the thesis .bib file as a single source of truth: fetch verified BibTeX from a DOI, arXiv id, or title via CrossRef and arXiv, normalise citation keys…
Expand a set of key papers into the literature around them by walking the citation graph with the Semantic Scholar and OpenAlex APIs: backward (references),…
Audit every citation in a chapter, paper, or proposal against the .bib file and the real world: each cite key must exist, each entry must resolve to a live DOI…
Write a thesis in Word without losing the discipline of a source-controlled workflow: author chapters in Markdown or LaTeX, convert with pandoc and a reference…