К основному содержанию
скилл CX Codex

figshare-skill — скилл для Claude Code: работа с Figshare

Скилл для Claude Code ищет и скачивает публичные материалы Figshare, а также управляет статьями и файлами аккаунта через API. Загружает наборы данных и публикует статьи.

MIT 299 установок ★ 107 обновлён 2026-10-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Agents365-ai/365-skills --skill figshare-skill -a claude-code
Открыть на GitHub

Что делает figshare-skill

Скилл обращается к Figshare v2 REST API: ищет публичные статьи, получает их по ID или DOI и скачивает файлы. Для аккаунта он умеет просматривать статьи, создавать черновики, менять метаданные, публиковать материалы, создавать коллекции и проекты. Публичный поиск и скачивание работают без токена.

Для загрузок есть скрипты upload.sh, download.sh и new-version.sh; большие файлы отправляются частями, после чего загрузку нужно завершить вызовом API. Понадобятся curl и jq в PATH. Для действий с аккаунтом и загрузки файлов нужен FIGSHARE_TOKEN. Публикация и другие изменения в аккаунте требуют подтверждения: публикация фиксирует версию и присваивает DOI.

Какие задачи решает

  • найти публичную статью по названию или DOI
  • скачать все файлы из статьи Figshare
  • создать черновик статьи с метаданными
  • загрузить файл в черновик частями
  • опубликовать новую версию статьи

Примеры запросов агенту

  • Найди публичные статьи Figshare о single cell и покажи их DOI.
  • Скачай все файлы статьи Figshare по DOI в каталог data.
  • Создай черновик статьи для набора данных и загрузи в него results.csv. Перед публикацией спроси меня.

Как установить figshare-skill

1Через Skills CLI (Vercel)

npx skills add Agents365-ai/365-skills --skill figshare-skill -a claude-code

2Вручную: положить файлы

~/.claude/skills/figshare-skill/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/figshare-skill/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о figshare-skill

Как установить figshare-skill в Claude Code?

Выполните npx skills add Agents365-ai/365-skills --skill figshare-skill -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/figshare-skill/SKILL.md.

Что делает figshare-skill?

Он ищет и скачивает публичные материалы Figshare, а через API аккаунта помогает создавать и менять статьи, загружать файлы и публиковать версии.

Нужен ли токен для работы с Figshare?

Для публичного поиска, статей и скачивания токен не нужен. Для запросов к аккаунту и загрузки файлов понадобится персональный токен в переменной FIGSHARE_TOKEN.

Исходный текст

SKILL.md · MIT
---
disable-model-invocation: true
name: figshare-skill
description: Use whenever the user wants to interact with Figshare - searching public datasets/articles, downloading Figshare files, listing their own articles/collections/projects, creating or updating articles, or uploading files (including large multi-part uploads) via the Figshare v2 REST API. Trigger on mentions of "figshare", figshare DOIs (10.6084/m9.figshare.*), figshare.com URLs, or phrases like "upload my dataset to figshare", "publish to figshare", "get figshare article".
homepage: https://github.com/Agents365-ai/365-skills
license: MIT
---

# Figshare Skill

Interact with the [Figshare v2 REST API](https://docs.figshare.com/) to search, download, create, and upload research outputs.

## Prerequisites

- `curl` and `jq` available on PATH.
- For authenticated endpoints (anything under `/account/...` or uploads), a **personal token** from <https://figshare.com/account/applications> exported as:

  ```bash
  export FIGSHARE_TOKEN=xxxxxxxxxxxxxxxx
  ```

- Public endpoints (search, public articles, downloads) need no token.

Always confirm with the user before creating, modifying, publishing, or deleting anything on their account — these are hard to reverse.

## Update check

Throttle to one check per 24 hours per installation; never mutate the skill directory without explicit user consent.

1. If `<this-skill-dir>/.last_update` exists and is less than 24 hours old, skip this step entirely.

2. Otherwise, fetch the latest tag from upstream:

   ```bash
   git -C <this-skill-dir> ls-remote --tags origin 'v*' 2>/dev/null \
     | awk '{print $2}' | sed 's|refs/tags/||' \
     | sort -V | tail -1
   ```

3. Compare with this skill's `metadata.version` from the frontmatter. If the upstream tag is strictly newer (semver), tell the user one line and ask:

   > "A newer version of this skill is available: vX.Y.Z → vA.B.C. Want me to `git pull`?"

   If they say yes, run `git -C <this-skill-dir> pull --ff-only`. Refresh `.last_update` either way so the prompt doesn't repeat for 24 hours.

4. If upstream is the same or older, refresh `.last_update` silently and continue.

5. On any failure (offline, not a git checkout — e.g. ClawHub-installed copy, read-only path, no permission), swallow the error silently and continue with the user's task. Do not mention the failure.

## API Basics

- **Base URL:** `https://api.figshare.com/v2`
- **Auth header:** `Authorization: token $FIGSHARE_TOKEN`
- **Content-Type:** `application/json` for POST/PUT bodies
- **Rate limit:** keep it under ~1 request/second to avoid abuse throttling
- **Errors:** JSON body with `message`, `code`; common codes 400/401/403/404/422

## Common Recipes

### Search public articles

```bash
curl -s -X POST https://api.figshare.com/v2/articles/search \
  -H "Content-Type: application/json" \
  -d '{"search_for": ":title: single cell", "page_size": 20}' | jq
```

Field operators: `:title:`, `:author:`, `:tag:`, `:category:`, `:doi:`, `:resource_doi:`.

### Get a public article (by ID or DOI)

```bash
curl -s https://api.figshare.com/v2/articles/{article_id} | jq
# or resolve from a figshare.com URL: the numeric tail is the article_id
```

### Download all files from a public article

```bash
ART=12345678
curl -s https://api.figshare.com/v2/articles/$ART/files \
  | jq -r '.[] | "\(.download_url)\t\(.name)"' \
  | while IFS=$'\t' read -r url name; do curl -L -o "$name" "$url"; done
```

### List your own articles

```bash
curl -s -H "Authorization: token $FIGSHARE_TOKEN" \
  "https://api.figshare.com/v2/account/articles?page=1&page_size=50" | jq
```

### Create an article (draft)

```bash
curl -s -X POST https://api.figshare.com/v2/account/articles \
  -H "Authorization: token $FIGSHARE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My dataset",
    "description": "Full description here.",
    "defined_type": "dataset",
    "tags": ["demo"],
    "categories": [2]
  }' | jq
```

Response is `{ "location": ".../account/articles/{id}", "entity_id": 123 }`.

### Update / publish an article

```bash
# update metadata
curl -s -X PUT https://api.figshare.com/v2/account/articles/$ART \
  -H "Authorization: token $FIGSHARE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "New title"}'

# publish (becomes public, assigns DOI, version is frozen)
curl -s -X POST https://api.figshare.com/v2/account/articles/$ART/publish \
  -H "Authorization: token $FIGSHARE_TOKEN"
```

Always ask before publishing — it's permanent for that version.

### Collections & projects

```bash
# create collection that groups existing articles
curl -s -X POST https://api.figshare.com/v2/account/collections \
  -H "Authorization: token $FIGSHARE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Collection", "articles": [123, 456]}'

# create project
curl -s -X POST https://api.figshare.com/v2/account/projects \
  -H "Authorization: token $FIGSHARE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Research Project"}'
```

## Uploading Files (Multi-part Flow)

Figshare uploads are **3-step**: initiate → PUT each part → complete. Use the bundled helpers for anything non-trivial:

```bash
# upload a file to an existing draft article
./scripts/upload.sh <article_id> <path/to/file>

# batch-download every file from a public article (accepts id or figshare.com URL)
./scripts/download.sh <article_id_or_url> [output_dir]

# reserve + upload + publish a new version of an already-published article
./scripts/new-version.sh <article_id> <path/to/file>
```

The raw flow, in case you need to adapt it:

1. **Initiate** — compute md5 + size, POST to article:

   ```bash
   SIZE=$(stat -f%z "$FILE" 2>/dev/null || stat -c%s "$FILE")
   MD5=$(md5sum "$FILE" | awk '{print $1}')   # or: md5 -q on macOS
   curl -s -X POST https://api.figshare.com/v2/account/articles/$ART/files \
     -H "Authorization: token $FIGSHARE_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"md5\":\"$MD5\",\"name\":\"$(basename $FILE)\",\"size\":$SIZE}"
   ```

   Response has `location` pointing at `/account/articles/$ART/files/$FILE_ID`.

2. **Fetch upload info** from that file record — it contains an `upload_url`. GET the upload_url to learn the part layout (`parts: [{partNo, startOffset, endOffset}]`).

3. **Upload parts** — for each part, PUT the byte range to `${upload_url}/${partNo}`:

   ```bash
   dd if="$FILE" bs=1 skip=$START count=$((END-START+1)) 2>/dev/null \
     | curl -s -X PUT --data-binary @- "${upload_url}/${partNo}" \
       -H "Authorization: token $FIGSHARE_TOKEN"
   ```

4. **Complete** — POST to the file record to finalize:

   ```bash
   curl -s -X POST https://api.figshare.com/v2/account/articles/$ART/files/$FILE_ID \
     -H "Authorization: token $FIGSHARE_TOKEN"
   ```

Why three steps: Figshare streams large files through a separate upload service. Skipping the complete call leaves the file in a pending state and it won't appear on the article.

## Pagination

Most list endpoints accept either `page`+`page_size` or `limit`+`offset`. Max `page_size` is typically 1000. For large harvests, loop until an empty page:

```bash
page=1
while :; do
  out=$(curl -s "https://api.figshare.com/v2/articles?page=$page&page_size=100")
  [ "$(echo "$out" | jq 'length')" = "0" ] && break
  echo "$out" | jq -c '.[]'
  page=$((page+1))
  sleep 1
done
```

## Troubleshooting

- **401** — token missing/expired; re-check `$FIGSHARE_TOKEN`.
- **403** on `/account/...` — token lacks the needed scope; regenerate with full permissions.
- **422** on article create — missing required field (usually `title`) or bad `categories`/`defined_type`.
- **Upload parts mismatch** — md5 or size in step 1 didn't match the bytes actually uploaded; recompute and restart.
- **Published article won't update** — publishing freezes a version; create a new version instead.

## References

- API reference: <https://docs.figshare.com/>
- Token management: <https://figshare.com/account/applications>
- Category IDs: `GET https://api.figshare.com/v2/categories`
- License IDs: `GET https://api.figshare.com/v2/licenses`

© Agents365-ai · MIT · Agents365-ai/365-skills

Похожие скиллы

Каталог скиллов SKILL.md →
find-skills vercel-labs Скилл find-skills для Claude Code ищет скиллы по задаче и помогает выбрать, что установить. Он включается, когда нужно найти готовую возможность для агента. CX Codex +1 4 400 000установок frontend-design официальный anthropics Скилл frontend-design для Claude Code задаёт осмысленное визуальное направление для новых интерфейсов и редизайна. Помогает уйти от шаблонного UI. CX Codex +1 1 025 790установок agent-browser vercel-labs Скилл agent-browser для Claude Code управляет браузером по запросам на навигацию, заполнение форм и проверку веб-приложений. Агент также может запускать через него исследовательское тестирование и автоматизировать Electron-приложения. CX Codex +1 1 600 000установок design-taste-frontend Leonxlnx Скилл design-taste-frontend для Claude Code задаёт правила оформления и проверки сайтов. Подключается при создании или переделке страницы, а также при просьбе убрать шаблонный вид. CX Codex +1 802 600установок grill-me Matt Pocock Скилл grill-me проводит жёсткое интервью по плану или дизайну, чтобы найти пробелы и уточнить решения. Подойдёт перед началом разработки. CX Codex +1 1 424 476установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок

Из того же набора33

Весь набор →
xfetch Скилл xfetch для Claude Code выгружает публичные твиты, профили и лайки из X через локальный скрипт без платного API. Собирает архивы и отслеживает аккаунты. CX Codex +1 316установок bbc-skill Скилл bbc-skill для Claude Code собирает комментарии к видео Bilibili в JSONL и сводку JSON. Данные охватывают отдельное видео или ролики автора для анализа откликов. CX Codex +1 313установок scientific-thinking Скилл scientific-thinking для анализа научных данных, оценки доказательств и конструирования аргументов. Помогает различить факты от интерпретаций, рассмотреть альтернативные объяснения и сформулировать выводы с чётким указанием их границ. CX Codex +1 308установок grant-thinking-general Скилл grant-thinking-general разбирает идеи грантов и логику исследовательских заявок: помогает уточнить проблему, цели, инновацию и выполнимость. CX Codex +1 301установок scientific-thinking-biology Скилл scientific-thinking-biology для Claude Code структурирует анализ биологических исследований и генетических данных. Помогает отличить ассоциацию от причинности, маркер от драйвера. CX Codex +1 296установок grant-thinking-cn-biology Скилл grant-thinking-cn-biology проверяет биологическую грантовую идею до подачи: есть ли за ней настоящий научный вопрос, где механизм и по силам ли масштаб выбранному уровню. CX Codex +1 295установок zotero-dev-rules Скилл zotero-dev-rules помогает разрабатывать плагины для Zotero и подключаться к Web API v3 без ручного поиска по документации. CX Codex +1 293установок zenodo-skill Скилл проводит через работу с Zenodo REST API: загрузку файлов, настройку метаданных, публикацию и выпуск новой версии записи. CX Codex +1 292установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой