skills/16-hsantanna88-clo-author/dot-claude/skills/tools/SKILL.md
Utility commands — commit, compile, validate-bib, journal, context-status, deploy, learn. Replaces individual utility skills.
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research toolsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Utility subcommands for project maintenance and infrastructure.
Input: $ARGUMENTS — subcommand followed by any arguments.
/tools commit [message] — Git CommitStage changes, create commit, optionally create PR and merge.
/tools compile [file] — LaTeX Compilation3-pass XeLaTeX + bibtex compilation.
For papers:
cd Paper && TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode [file]
BIBINPUTS=..:$BIBINPUTS bibtex [file_base]
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode [file]
TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode [file]
For talks:
cd Talks && TEXINPUTS=../Preambles:$TEXINPUTS xelatex -interaction=nonstopmode [file]
/tools validate-bib — Bibliography ValidationCross-reference all \cite{} keys in paper and talk files against Bibliography_base.bib. Report: missing entries, unused entries, duplicate keys.
/tools journal — Research JournalRegenerate the research journal timeline from quality reports and git history. Shows chronological record of agent actions, phase transitions, scores, decisions.
/tools context — Context StatusShow current context status and session health. Check context usage, whether auto-compact is approaching, what state will be preserved.
/tools deploy — Deploy Guide SiteRender Quarto guide site and publish to GitHub Pages.
cd guide && quarto publish gh-pages --no-browser
/tools learn — Extract LearningsExtract reusable knowledge from the current session. Auto-memory handles corrections automatically; this is for multi-step workflows worth turning into a full skill.
/tools upgrade — Upgrade Clo-Author InfrastructureUpgrade an existing project to the latest clo-author architecture.
What it does:
.claude/ directory.claude/ intemplates/Workflow:
Step 1: DOWNLOAD
- Clone latest clo-author into /tmp/clo-author-upgrade
- Or: gh release download --repo hugosantanna/clo-author
Step 2: PRESERVE USER CUSTOMIZATIONS
- Save .claude/references/domain-profile.md if filled in (not just placeholders)
- Save any custom journal profiles the user added to journal-profiles.md
- Save .claude/settings.json (user's permissions and hooks)
- Save .claude/settings.local.json if it exists
Step 3: REPLACE
- Delete old .claude/ entirely
- Copy new .claude/ from the downloaded release
- Restore saved customizations from Step 2
Step 4: DO NOT TOUCH
- paper/, scripts/, data/, explorations/, quality_reports/
- CLAUDE.md, Bibliography_base.bib, README.md, .gitignore
- Any other user content
Step 5: REPORT
- List what was updated (new agents, skills, rules)
- List what was preserved (domain profile, settings, custom profiles)
- Clean up temp directory
No git merge. No upstream remote. No conflicts. Just delete and replace .claude/.
development
Conduct rigorous thematic analysis (TA) of qualitative data following Braun and Clarke's (2006) six-phase framework. Use whenever the user mentions 'thematic analysis', 'TA', 'Braun and Clarke', 'qualitative coding', 'identifying themes', or asks for help analysing interviews, focus groups, open-ended survey responses, or transcripts to identify patterns. Also trigger for questions about inductive vs theoretical coding, semantic vs latent themes, essentialist vs constructionist epistemology, building a thematic map, or writing up a qualitative findings section. Covers all six phases, the four upfront analytic decisions, the 15-point quality checklist, and the five common pitfalls. Produces a Word document write-up and an annotated thematic map. Does NOT cover IPA, grounded theory, discourse analysis, conversation analysis, or narrative analysis — use a different method for those.
development
Guide users through writing a systematic literature review (SLR) following the PRISMA 2020 framework. Use this skill whenever the user mentions 'systematic review', 'systematic literature review', 'SLR', 'PRISMA', 'PRISMA 2020', 'PRISMA flow diagram', 'PRISMA checklist', or asks for help writing, structuring, or auditing a literature review that follows reporting guidelines. Also trigger when the user asks about inclusion/exclusion criteria for a review, search strategies for databases like Scopus/WoS/PubMed, study selection processes, risk of bias assessment, or narrative synthesis for a review paper. This skill covers the full PRISMA 2020 checklist (27 items), produces a Word document manuscript in strict journal article format, generates an annotated PRISMA flow diagram, and enforces APA 7th Edition referencing throughout. It does NOT cover meta-analysis or statistical pooling. By Chuah Kee Man.
testing
Performs placebo-in-time sensitivity analysis with hierarchical null model and optional Bayesian assurance. Use when checking model robustness, verifying lack of pre-intervention effects, or estimating study power.
data-ai
Fit, summarize, plot, and interpret a chosen CausalPy experiment. Use after the causal method has been selected, including when configuring PyMC/sklearn models and scale-aware custom priors.