Przejdź do treści
Biblioteka skilli
Nauka i badania · Integracja z narzędziem

connect-overleaf-project

/connect-overleaf-project

Łączy projekt Overleaf, na przykład artykuł lub pracę dyplomową, z projektem Calkit i skryptami, aby rysunki i liczby pochodziły z potoku.

Repozytorium
calkit ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Łączy projekt Overleaf, na przykład artykuł lub pracę dyplomową, z projektem Calkit i skryptami, aby rysunki i liczby pochodziły z potoku.

Oryginalny opis (EN)

Connect an Overleaf project, e.g., a paper, thesis, or poster, to a Calkit project and the scripts and data behind it, so its figures and numbers come from a pipeline. Use when the user invokes `/calkit:connect-overleaf-project`, asks to connect an Overleaf project (often one open in their browser) to Calkit, or asks to make an Overleaf document reproducible. Not for only signing in to Overleaf.

Jak działa

  1. 1. Connect the document
  2. 2. Clone it
  3. 3. Find what the document shows and where it came from
  4. 4. Bring in the scripts and data
  5. 5. Have the document read the outputs
  6. 6. Say where everything starts
  7. 7. Run, save, and sync
Sekcje z nagłówków SKILL.md, w oryginale · 157 linii, 862 słów
Podgląd SKILL.md
---
name: connect-overleaf-project
description: Connect an Overleaf project, e.g., a paper, thesis, or poster,
  to a Calkit project and the scripts and data behind it, so its figures and
  numbers come from a pipeline. Use when the user invokes
  `/calkit:connect-overleaf-project`, asks to connect an Overleaf project
  (often one open in their browser) to Calkit, or asks to make an Overleaf
  document reproducible. Not for only signing in to Overleaf.
---

# Connect an Overleaf project to its analysis

The person writes in Overleaf, e.g., a paper, thesis, or poster, and their
scripts and data are somewhere on their machine or a shared drive. The job is
to connect the two: a Calkit project with the document in it, stages that make
what the document shows, and the document reading those outputs instead of
pasted copies. The writing stays theirs. Change only how the document includes
figures and numbers.

Work in two places:

- **The browser**, through the person's own Overleaf session, for what only
  it can do: connecting the document, and checking the result in the editor.
  This needs a browser tool, e.g., Claude in Chrome.
- **A local clone**, through the CLI, for everything else.

Never type passwords or tokens. If something asks the person to sign in,
stop and ask them to do it.

## 1. Connect the document

In the Overleaf tab, open the Calkit panel from the launcher at the bottom
right, which reads "Calkit: not linked" when the document isn't connected. It's
in a shadow root, so it may not show in the page's accessibility tree; take a
screenshot to find it.

Click "Make this paper reproducible", check the project name, privacy, and
folder, and create the project. Name the folder for what the document is,
e.g., `paper` only for a paper, and `thesis` for a thesis. A project with
several publications may keep them under `pubs`, e.g., `pubs/paper-1` and
`pubs/thesis`, and presentations under `presentations`. The panel then
shows the project and "in sync". If the document should go in a project the
person already has, use "Use a project I already have" instead.

Without the browser extension, `calkit overleaf import URL SUBFOLDER` adds the
document to an existing local project, using Overleaf's Git access.

## 2. Clone it

```bash
calkit clone OWNER/NAME ~/calkit/NAME
```

`~/calkit/` is the usual place, unless the person keeps projects elsewhere,
e.g., `~/research` or `~/dev`.

## 3. Find what the document shows and where it came from

Read the document's `.tex` files and list:

- figures included from files in the document's folder, e.g., a pasted
  `\includegraphics{drag.png}`
- numbers typed into the text that are results, e.g., a mean or a fit
  parameter
- tables typed or pasted in

Then find the scripts and data that made them. Ask the person where they
keep their analysis before searching their files. Match a figure to its
script by its file name, `savefig` calls, axis labels, and data columns.
Don't move or delete anything in their folders; copy what the project needs.

## 4. Bring in the scripts and data

Copy scripts into `scripts/` and data into `data/`, then change paths in the
scripts to be relative to the project root. Where a number in the text comes
from a script, have the script write it to a results file, e.g.,
`results/drag.json`, rather than only printing it.

Add each script as a stage, previewing first:

```bash
calkit xr scripts/plot_drag.py --dry-run
calkit xr scripts/plot_drag.py
```

Check the detected inputs, outputs, and environment in `calkit.yaml`. Large
data belongs in DVC; see the conventions skill.

## 5. Have the document read the outputs

Load the package and swap each pasted figure and typed result for the
output that makes it:

```latex
\usepackage{calkit}
...
The mean drag coefficient was \ckvalue{results/drag.json}{mean_cd}.
\ckfigure[width=0.6\linewidth]{figures/drag.png}
\cktable{results/summary.tex}
```

Remove the pasted copies the document no longer includes, and drop them from
the LaTeX stage's `inputs`.

## 6. Say where everything starts

Data at the start of the chain needs an origin: `created_by` for data the
person measured or collected, or `imported_from` with a public URL or DOI
for data from elsewhere. A file on their laptop or a private drive isn't
somewhere it can be imported from. Ask the person which it is; don't guess.

```yaml
datasets:
  - path: data/drag_data_FINAL.csv
    title: Drag measurements
    created_by:
      - name: Their Name
        email: them@example.edu
```

A PNG or PDF can't be created by a person, since an app or script exports
it. If no script makes it, ask the person what they made it in, copy that
file into the project, e.g., `figures/src/setup.svg`, and add a stage that
exports it. Inkscape SVGs and GIMP files are exported as the pipeline runs;
anything else is a manual step, which asks the person to export it again
when its file changes:

```yaml
pipeline:
  stages:
    export-setup:
      kind: inkscape-export # or gimp-export
      source_path: figures/src/setup.svg
      outputs:
        - paper/setup.png
    export-diagram:
      kind: manual-step
      message: In PowerPoint, export paper/diagram.png from slide 2
      open:
        app: PowerPoint
        path: figures/src/diagram.pptx
      inputs:
        - figures/src/diagram.pptx
      outputs:
        - paper/diagram.png
```

## 7. Run, save, and sync

```bash
calkit run --save --overleaf -m "Make the drag figure from its script"
calkit check repro
```

Then, in the Overleaf tab:

1. Dismiss Overleaf's "Document Updated Externally" notice, if shown.
2. Reload the page, since the extension remembers what it last looked up.
3. Recompile, and check that no "Origin not defined" marks remain in the
   editor or on the PDF.
4. Hover a `\ckvalue` or `\ckfigure` to confirm it traces back to its stage
   and data.

Tell the person what you connected, what you asked them about, and anything
left without an origin.

Wersje

W bazie nie ma innych skilli o nazwie connect-overleaf-project.

Migawka bazy z 13.11.2026 · wersja paczki e3d17aef5fa6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100create-pipeline
    Zamienia istniejące repozytorium z doraźnymi skryptami w w pełni odtwarzalny pipeline Calkit, aby projekt dało się powtórzyć od początku do końca.
  • 100overleaf-sync
    Synchronizuje dwukierunkowo lokalny katalog artykułu z projektem Overleaf, aby audyty działały lokalnie, a współautorzy edytowali w przeglądarce.
  • 100overleaf-sync
    Synchronizuje dwukierunkowo lokalny katalog artykułu z projektem Overleaf, aby przepływy audytu i edycji ARIS działały na lokalnej kopii, a współautorzy edytowali w interfejsie webowym.
  • 90work-with-overleaf
    Łączy projekt Overleaf z lokalnymi skillami, aby sprawdzić, dopracować i zrecenzować artykuł, a potem zsynchronizować zmiany z powrotem przez Git lub GitHub.
  • 100review-overleaf
    Pobiera komentarze recenzentów z Overleaf i nanosi je w lokalnym repozytorium LaTeX w git, synchronizując uwagi z lokalną wersją.
  • 100overleaf-setup
    Instaluje, loguje i rozwiązuje problemy z serwerem MCP overleaf-mcp-rt, w tym błędy uwierzytelniania, konfiguracji, proxy i wygasłego ciasteczka sesji.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.