Agent skill

Import Web Markdown With Gather

by ttscoff in ttscoff/gather-cli

Import web pages as clean markdown using the local gather CLI.

MITAuto-check passedDocuments & Office

Install Import Web Markdown With Gather

skills CLI
$ npx skills add ttscoff/gather-cli --skill import-web-markdown-with-gather -a claude-code

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

GitHub CLI
$ gh skill install ttscoff/gather-cli import-web-markdown-with-gather --agent claude-code

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

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

Facts

Skill name
import-web-markdown-with-gather
GitHub stars
162
Token cost
~623 tokens
SKILL.md length
215 words
Files
40 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Import web pages as clean markdown using the local gather CLI.

  • Works in 4 steps: Validate input → Run gather → On failure, retry with fallback mode → …
  • The user asks to fetch a URL as markdown
  • SKILL.md covers Purpose, Recommended Defaults, Required Workflow and Output Contract, plus 3 more sections
  • Runs Ruby and Swift scripts from its folder

What it does

Import Web Markdown With Gather is an agent skill from ttscoff/gather-cli. Import web pages as clean markdown using the local gather CLI. Use when the user asks to fetch a URL as markdown, clip a page into notes, archive readable article text, or convert web content into markdown for context.

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. The skill folder holds 46 other files, including scripts (for example `.github/workflows/release.yml`, `CHANGELOG.md` and `LICENSE.md`).

It sits in Documents & Office, covering Markdown. The licence is MIT.

When your agent uses it

  • The user asks to fetch a URL as markdown
  • Clip a page into notes
  • Archive readable article text
  • Convert web content into markdown for context

Example prompts

  • “/import-web-markdown-with-gather”

Workflow steps

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

  1. Validate input
  2. Run gather
  3. On failure, retry with fallback mode
  4. Return markdown text as the main result.

What it can do on your machine

Read from SKILL.md and the folder at commit f3ae4eb. 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 1 file in scripts/ (Ruby and Swift, from the files we listed), which the agent can run.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Import Web Markdown With Gather loads about 623 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 215 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~623

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 passed

The automated check found no risky patterns in SKILL.md.

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 ttscoff/gather-cli at commit f3ae4eb, republished under its MIT licence (© ttscoff). 215 words, ~623 tokens.

Download SKILL.mdSave it as .claude/skills/import-web-markdown-with-gather/SKILL.md (or your agent's skills folder). This skill also uses 39 other files; get the full folder from GitHub.
name
import-web-markdown-with-gather
description
Import web pages as clean markdown using the local gather CLI. Use when the user asks to fetch a URL as markdown, clip a page into notes, archive readable article text, or convert web content into markdown for context.

Import Web Markdown With Gather

Purpose

Use gather as the default local tool for converting a URL into readable markdown.

Run gather with these settings unless the user asks otherwise:

bash
gather --metadata-yaml --inline-links --no-paragraph-links "<url>"

Rationale:

  • --metadata-yaml: Adds title/date/source in front matter for downstream indexing.
  • --inline-links: Keeps links close to text for RAG/chunk readability.
  • --no-paragraph-links: Avoids repeated reference blocks after each paragraph.

Required Workflow

  1. Validate input:

    • Accept only http:// or https:// URLs.
    • If input is not a URL, ask for one.
  2. Run gather:

    • Primary command:

      bash
      gather --metadata-yaml --inline-links --no-paragraph-links "<url>"
  3. On failure, retry with fallback mode:

    • First fallback:

      bash
      gather --metadata-yaml --inline-links --no-paragraph-links \
        --no-readability "<url>"
    • If the page still fails and raw HTML is available, pass HTML directly:

      bash
      printf "%s" "$HTML" | gather --html --stdin --metadata-yaml \
        --inline-links --no-paragraph-links
  4. Return markdown text as the main result.

Output Contract

When successful, return:

  • url: original URL
  • title: extracted title when available
  • markdown: full markdown body
  • used_fallback: true if --no-readability or --html path was used

Safety And Limits

  • Do not execute JavaScript from pages.
  • Do not follow login-only pages automatically.
  • Preserve the original URL in output metadata.
  • If output is empty or too short, report a partial extraction warning.

Examples

Basic import:

bash
gather --metadata-yaml --inline-links --no-paragraph-links "https://example.com/article"

Fallback when readability extraction fails:

bash
gather --metadata-yaml --inline-links --no-paragraph-links --no-readability "https://example.com/article"

Optional Variants

  • Add title only:

    bash
    gather --title-only "<url>"
  • Plain body without source/title injection:

    bash
    gather --no-include-source --no-include-title "<url>"

© ttscoff, 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 39 other files (scripts) in the repository root of ttscoff/gather-cli.

  • SKILL.md
  • .github/workflows/release.yml
  • .gitignore
  • .gitmodules
  • .gitsecret/keys/crls.d/DIR.txt
  • .gitsecret/keys/pubring.kbx
  • .gitsecret/keys/trustdb.gpg
  • .gitsecret/paths/mapping.cfg
  • CHANGELOG.md
  • Formula/gather-cli.rb
  • LICENSE.md
  • Makefile
  • Package.resolved
  • Package.swift
  • … and 26 more

Open the folder on GitHubat commit f3ae4eb

Compare with similar skills

Import Web Markdown With Gather 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.

Import Web Markdown With Gather compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Import Web Markdown With Gather this skillttscoff/gather-cli162—~623Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills26k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
Gzh Designisjiamu/gzh-design-skill3.9k1 repos~2.2kAutomated safety check: PassAGPL-3.0
Crosspostingwasp-lang/wasp19k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    26k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Gzh Design

    isjiamu/gzh-design-skill

    微信公众号文章排版引擎,将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取,自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入(非 Markdown…

    3.9k GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Review The Docs

    supabase/supabase

    Official

    Review Supabase docs changes locally in your supabase/supabase checkout — either an open PR (triage, classify, verify) or your own branch before opening a PR (local self-review).

    111k GitHub stars~4.6k tokensUpdated today
    Documents & OfficeAuto-check passed

Questions about Import Web Markdown With Gather

What does Import Web Markdown With Gather do?

Import web pages as clean markdown using the local gather CLI. Import Web Markdown With Gather is an agent skill from ttscoff/gather-cli. Import web pages as clean markdown using the local gather CLI.

When should I use Import Web Markdown With Gather?

Import Web Markdown With Gather fits situations like: the user asks to fetch a URL as markdown; clip a page into notes; archive readable article text; convert web content into markdown for context.

How do I install Import Web Markdown With Gather in Claude Code?

Run `npx skills add ttscoff/gather-cli --skill import-web-markdown-with-gather -a claude-code`. Or copy the skill folder (the ttscoff/gather-cli repository) into .claude/skills/import-web-markdown-with-gather in your project. Claude Code loads it when a task matches its description.

How do I install Import Web Markdown With Gather in Codex?

Run `npx skills add ttscoff/gather-cli --skill import-web-markdown-with-gather -a codex`. Or copy the skill folder (the ttscoff/gather-cli repository) into .agents/skills/import-web-markdown-with-gather in your project. Codex loads it when a task matches its description.

Can I use Import Web Markdown With Gather 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 ttscoff/gather-cli --skill import-web-markdown-with-gather -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/import-web-markdown-with-gather, .gemini/skills/import-web-markdown-with-gather, .github/skills/import-web-markdown-with-gather and .opencode/skills/import-web-markdown-with-gather in your project.

What does Import Web Markdown With Gather need to run?

Going by SKILL.md and its folder, Import Web Markdown With Gather needs Ruby and Swift for the scripts in its folder.

Does Import Web Markdown With Gather access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Import Web Markdown With Gather safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Import Web Markdown With Gather use?

Import Web Markdown With Gather is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Import Web Markdown With Gather use?

About 623 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Import Web Markdown With Gather?

Skills that share tags, products or a category with Import Web Markdown With Gather: Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars), Markitdown (ImCa0/just-laws, 782 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and Gzh Design (isjiamu/gzh-design-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Import Web Markdown With Gather?

ttscoff (a GitHub user) maintains it in ttscoff/gather-cli, which has 162 GitHub stars. The repository was last updated on March 21, 2026.

Source: ttscoff/gather-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.