Agent skill

Sourcecraft Publisher

by artwist-polyakov in artwist-polyakov/polyakov-claude-skills

Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path.

MITAuto-check: notesFrontend & Design

Install Sourcecraft Publisher

skills CLI
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill sourcecraft-publisher -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install artwist-polyakov/polyakov-claude-skills sourcecraft-publisher --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/sourcecraft-publisher/skills/sourcecraft-publisher .claude/skills/sourcecraft-publisher && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sourcecraft-publisher
GitHub stars
208
Token cost
~990 tokens
SKILL.md length
431 words
Files
7 (incl. scripts, references)
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path.

  • Works in 7 steps: Determine the publish date bucket → Create or update target directory → Copy artifact files into that directory → …
  • A static page/React artifact needs to be deployed to SourceCraft under YYYY/YYYY-MM/page-slug directory layout
  • SKILL.md covers Required repository layout, What this skill expects, Config and Workflow, plus 7 more sections
  • Runs Python scripts from its folder; calls python3 and uv; needs SOURCECRAFT_TOKEN

What it does

Sourcecraft Publisher is an agent skill from artwist-polyakov/polyakov-claude-skills. Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path. Use when a static page/React artifact needs to be deployed to SourceCraft under YYYY/YYYY-MM/page-slug directory layout.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `config/README.md`, `references/publish-checklist.md` and `scripts/optimize_images.py`).

It sits in Frontend & Design, covering Web performance. It works with React. The repository describes itself as: Набор скиллов для Claude. The licence is MIT.

When your agent uses it

  • A static page/React artifact needs to be deployed to SourceCraft under YYYY/YYYY-MM/page-slug directory layout
  • Tasks that involve Web performance

Example prompts

  • “/sourcecraft-publisher”

Requirements

  • Python 3
  • A credential in SOURCECRAFT_TOKEN

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Determine the publish date bucket
  2. Create or update target directory
  3. Copy artifact files into that directory
  4. Verify there is an entrypoint (index.html normally)
  5. Ensure .sourcecraft/sites.yaml exists in repo root
  6. Commit and force-push to the SourceCraft repo
  7. Return the final public URL

What it can do on your machine

Read from SKILL.md and the folder at commit 8bbeead. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SOURCECRAFT_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sourcecraft Publisher loads about 990 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 431 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~990
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:37
    cp config/.env.example config/.env

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from artwist-polyakov/polyakov-claude-skills at commit 8bbeead, republished under its MIT licence (© artwist-polyakov). 431 words, ~990 tokens.

Download SKILL.mdSave it as .claude/skills/sourcecraft-publisher/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
sourcecraft-publisher
description
Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path. Use when a static page/React artifact needs to be deployed to SourceCraft under YYYY/YYYY-MM/page-slug directory layout.

SourceCraft Publisher

Publish already-built static artifacts to a SourceCraft Sites repository. Works from Russia (Yandex infrastructure).

This skill is the deployment/output layer for page artifacts created by other skills (e.g. telegram-channel-parser digest).

Required repository layout

Every published artifact must go into this path shape inside the target repo:

<year>/<year>-<month>/<page-slug>/

Example:

  • 2026/2026-03/ai-digest-week/

Never publish flat at repo root. Never skip the year or year-month nesting.

What this skill expects

Input should already exist as one of these:

  • a folder of built static files
  • a single HTML artifact plus local assets
  • a small static site ready to serve from a subdirectory

This skill does not do frontend design work. It packages and publishes what already exists.

Config

Read config/README.md for required environment variables and token setup.

bash
cp config/.env.example config/.env

Required: SOURCECRAFT_TOKEN, SOURCECRAFT_REPO, SOURCECRAFT_SITE_URL.

Workflow

  1. Determine the publish date bucket:
    • year = YYYY
    • year-month = YYYY-MM
  2. Create or update target directory:
    • <year>/<year-month>/<page-slug>/
  3. Copy artifact files into that directory
  4. Verify there is an entrypoint (index.html normally)
  5. Ensure .sourcecraft/sites.yaml exists in repo root
  6. Commit and force-push to the SourceCraft repo
  7. Return the final public URL

Publishing command

bash
python3 scripts/publish_static.py --source <dir-or-html> --slug <name> [--date YYYY-MM-DD] [--image-max-kb 500]

The script:

  • Clones the SourceCraft repo (shallow)
  • Ensures .sourcecraft/sites.yaml config exists
  • Copies artifact into YYYY/YYYY-MM/slug/
  • Optimizes oversized .jpg, .jpeg, .png, and .webp images before commit
  • Commits and force-pushes
  • Prints the final public URL
Show full SKILL.md (214 more words)Show less

Image optimization

Image optimization is a recommendation, not a hard requirement. By default, the publishing script tries to keep each raster image under 500KB by stripping metadata, recompressing, and resizing long edges when needed.

Use --image-max-kb <kb> for a different target. Use --keep-large-images or --image-max-kb 0 when the user explicitly needs original-size images (for example, a full-resolution infographic, map, or downloadable media asset).

The original --source artifact is not changed. Optimization happens only after files are copied into the publish repo target directory. If Pillow/uv is unavailable or optimization fails, continue publishing originals and mention the warning.

Manual console run for a prepared artifact:

bash
uv run --with pillow python3 scripts/optimize_images.py <artifact-dir> --max-kb 500

Slug rules

  • use lowercase letters, digits, and hyphens
  • keep it short and descriptive
  • avoid spaces, underscores, Cyrillic

URL contract

Always return the final public URL: <SOURCECRAFT_SITE_URL>/<year>/<year>-<month>/<page-slug>/

Pre-publish validation

Before pushing, verify:

  • artifact has index.html entrypoint
  • oversized raster images are optimized when practical, unless original-size sharing is intentional
  • no absolute local paths in HTML/CSS
  • no secrets in files
  • all local assets reachable from the target folder

Safety rules

  • do not delete unrelated directories in the repo
  • only replace contents of the target page directory
  • if overwriting, say so in the result
  • do not expose the token in output, logs, or committed files

References

Read if needed:

  • references/publish-checklist.md — operational checklist before pushing

© artwist-polyakov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in plugins/sourcecraft-publisher/skills/sourcecraft-publisher of artwist-polyakov/polyakov-claude-skills.

  • SKILL.md
  • .gitignore
  • config/.env.example
  • config/README.md
  • references/publish-checklist.md
  • scripts/optimize_images.py
  • scripts/publish_static.py

Open the folder on GitHubat commit 8bbeead

Compare with similar skills

Sourcecraft Publisher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sourcecraft Publisher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sourcecraft Publisher this skillartwist-polyakov/polyakov-claude-skills208—~990Automated safety check: NotesMIT
React Doctormakeplane/plane61k12 repos~657Automated safety check: PassAGPL-3.0
React Frontend Development Guidelinesdiet103/claude-code-infrastructure-showcase10k2 repos~2.9kAutomated safety check: PassMIT
Core Web VitalsvmDeshpande/ai-agent-automation1784 repos~3.6kAutomated safety check: PassMIT
Reduce Bundle Sizekcsujeet/ilamy-calendar351—~2.9kAutomated safety check: PassMIT
Shader for Interfacesv2space-labs/shader-for-interfaces116—~3.1kAutomated safety check: PassMIT

Similar skills

  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    61k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed
  • React Frontend Development Guidelines

    diet103/claude-code-infrastructure-showcase

    Guidelines for React 18 and TypeScript apps covering Suspense data fetching, lazy loading, feature folders, MUI v7 styling, TanStack Router and performance.

    10k GitHub starsUsed in 2 repos~2.9k tokens
    Frontend & DesignAuto-check passed
  • Core Web Vitals

    vmDeshpande/ai-agent-automation

    Optimize Core Web Vitals (LCP, INP, CLS) for better page experience and search ranking.

    178 GitHub starsUsed in 4 repos~3.6k tokens
    Frontend & DesignAuto-check passed
  • Reduce Bundle Size

    kcsujeet/ilamy-calendar

    Systematically reduce the shipped bundle size of a JS/TS library without sacrificing code readability or breaking consumer APIs.

    351 GitHub stars~2.9k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Shader for Interfaces

    v2space-labs/shader-for-interfaces

    Decides whether an interface effect belongs in CSS, SVG, Canvas 2D, WebGL or WebGPU, then builds, debugs and visually verifies focused GPU effects inside product UIs.

    116 GitHub stars~3.1k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Ssr Boost Migrate

    Lomray-Software/vite-ssr-boost

    Migrate an existing Vite and React Router SPA to vite-ssr-boost SSR in Data mode, preserving route objects and checking streaming, hydration, bundle size, and deployment readiness.

    118 GitHub stars~2.3k tokensUpdated 17 days ago
    Frontend & DesignAuto-check passed

More from artwist-polyakov/polyakov-claude-skills

All 21 skills in this repo
  • Agent Deck Sessions

    artwist-polyakov/polyakov-claude-skills

    Launches, monitors and collects results from child AI agent sessions with the agent-deck terminal session manager.

    208 GitHub stars~965 tokensUpdated 2 days ago
    Auto-check passed
  • Crawl4AI SEO Site Crawler

    artwist-polyakov/polyakov-claude-skills

    Crawls a site with Crawl4AI to audit titles, meta tags, H1s, canonicals, navigation and internal links, and to compare landing pages and competitor sites.

    208 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • GitHub Pages Publisher

    artwist-polyakov/polyakov-claude-skills

    Publishes already-built static pages to a GitHub Pages repo under a year, year-month and slug folder layout, optimizes large images and returns the public URL.

    208 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Perplexity Search and Research

    artwist-polyakov/polyakov-claude-skills

    Shell scripts for web search and research through the Perplexity API: raw results, cited answers, background deep research and page fetching, with results cached on disk.

    208 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check: notes
  • X/Twitter Research via Grok

    artwist-polyakov/polyakov-claude-skills

    Searches X/Twitter through the xAI Grok API to build digests, trend reports and thread analysis, meant to surface post ideas for a Telegram channel.

    208 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check: notes
  • Yandex Metrika

    artwist-polyakov/polyakov-claude-skills

    Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам.

    208 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Questions about Sourcecraft Publisher

What does Sourcecraft Publisher do?

Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path. Sourcecraft Publisher is an agent skill from artwist-polyakov/polyakov-claude-skills. Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path.

When should I use Sourcecraft Publisher?

Sourcecraft Publisher fits situations like: A static page/React artifact needs to be deployed to SourceCraft under YYYY/YYYY-MM/page-slug directory layout; tasks that involve Web performance.

How do I install Sourcecraft Publisher in Claude Code?

Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill sourcecraft-publisher -a claude-code`. Or copy the skill folder (plugins/sourcecraft-publisher/skills/sourcecraft-publisher in artwist-polyakov/polyakov-claude-skills) into .claude/skills/sourcecraft-publisher in your project. Claude Code loads it when a task matches its description.

How do I install Sourcecraft Publisher in Codex?

Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill sourcecraft-publisher -a codex`. Or copy the skill folder (plugins/sourcecraft-publisher/skills/sourcecraft-publisher in artwist-polyakov/polyakov-claude-skills) into .agents/skills/sourcecraft-publisher in your project. Codex loads it when a task matches its description.

Can I use Sourcecraft Publisher in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add artwist-polyakov/polyakov-claude-skills --skill sourcecraft-publisher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sourcecraft-publisher, .gemini/skills/sourcecraft-publisher, .github/skills/sourcecraft-publisher and .opencode/skills/sourcecraft-publisher in your project.

What does Sourcecraft Publisher need to run?

Going by SKILL.md and its folder, Sourcecraft Publisher needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and uv) and credentials named SOURCECRAFT_TOKEN. Our summary lists: Python 3; A credential in SOURCECRAFT_TOKEN.

Does Sourcecraft Publisher access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Sourcecraft Publisher safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sourcecraft Publisher use?

Sourcecraft Publisher is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sourcecraft Publisher use?

About 990 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 98 tokens, read only when the agent opens those files.

What are the alternatives to Sourcecraft Publisher?

Skills that share tags, products or a category with Sourcecraft Publisher: React Doctor (makeplane/plane, 61k stars), React Frontend Development Guidelines (diet103/claude-code-infrastructure-showcase, 10k stars), Core Web Vitals (vmDeshpande/ai-agent-automation, 178 stars) and Reduce Bundle Size (kcsujeet/ilamy-calendar, 351 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sourcecraft Publisher?

artwist-polyakov (a GitHub user) maintains it in artwist-polyakov/polyakov-claude-skills, which has 208 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 8, 2026.

Source: artwist-polyakov/polyakov-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.