develop-contribution
Use when creating a new contribution (analysis, experiment, dataset, software, reproduction) or regularizing a draft folder into badge compliance with its LaTeX report.
How do I install this agent skill?
npx skills add https://github.com/vincenzoimp/academic-research-skills --skill develop-contributionIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a structured workflow for research and software development contributions. It utilizes standard developer tools such as 'uv' and 'make' for dependency management and build processes. A potential risk is identified in the reproduction workflow, which involves the agent reading and interpreting instructions from external, untrusted repositories, creating a surface for indirect prompt injection.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Develop Contribution
Create or regularize one contributions/<slug>/ folder: badge-general
compliant, self-contained, with a report/report.tex detailed enough that
paper writing never needs to re-read the code.
Read First
contributions/README.md— the badge-general contractsurvey/survey.pdf, gaps section — when positioning a new contributionreferences/methodology.md— evaluation, statistics, figure disciplinereferences/experiments.md— run logs and autonomous campaignsreferences/reproduction.md— reproducing external workreferences/ethics.md— data red flagsreferences/data.md— data placement and inter-contribution data dependencies (when the contribution has shared/large data or consumes another contribution's output)
Before Building (both modes)
Fill the Positioning section of the contribution README:
- the claim this contribution will support
- the delta vs the nearest prior work (cite survey/SOTA citekeys)
- the evidence plan: what will be measured or collected, and how
- the falsifiability condition: what outcome would refute the claim
If the claim has no evidence path, stop and discuss with the user.
Create Mode
- Copy
contributions/_template/tocontributions/<slug>/(kebab-case slug). - Python code? Write the contribution's own
pyproject.toml(name, requires-python, dependencies), add"contributions/<slug>"to[tool.uv.workspace] membersin the rootpyproject.toml, runuv sync --all-packagesfrom the root (plainuv syncprunes the members' dependencies on apackage = falseroot). Genuinely conflicting dependencies → move the path toexclude, create a local venv, document it in the README. - Develop inside the folder — free-form structure (
src/,data/,figures/,outputs/, notebooks). Followreferences/methodology.mdfor any evaluation; keep a run log perreferences/experiments.mdfor every run that supports a claim, including autonomous campaigns. For reproductions of external work, followreferences/reproduction.md. - Fill the README badge checklist truthfully — every checked box has
evidence inside the folder. Check data against
references/ethics.md. - Write
report/report.tex: motivation, positioning vs the SOTA (cite the root.bib), method, setup, results with figures/tables, limitations. Build it:make contribution C=<slug>. - Run
make check.
Regularize Mode
- Inventory the draft folder: what exists, what it claims, what is missing against the badge checklist.
- Reorganize in place — keep provenance (note original filenames when renaming), capture the environment, verify the run path works end-to-end, record data provenance and ethics flags.
- Continue with Create Mode steps 4–6.
Rules
- Self-contained: no imports from other contributions; tooling worth
sharing becomes its own contribution referenced in the README. If the input
is another contribution's output, declare it and read it in place — never
copy (see
references/data.md). - Exploratory results never masquerade as confirmed evidence — label them.
- Negative results are results: report them in report.tex.
Done When
- Badge checklist fully and truthfully checked,
report.pdfbuilt, workspace coherent,make checkpasses
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/vincenzoimp/academic-research-skills/develop-contribution">View develop-contribution on skillZs</a>