necvk

Convert any URL to clean markdown or forge agent-ready skill.md files from your terminal.

npx @divikk/necvk convert https://medium.com/some-article
npx @divikk/necvk forge https://react.dev/learn --key sk-xxx --mode howto

Install

npm install -g @divikk/necvk
# or just use npx (no install needed):
npx @divikk/necvk forge <url>

Commands

convert — Free, unlimited markdown extraction

necvk convert <url|file>

# Examples
necvk convert https://medium.com/article          # extracts clean markdown
necvk convert https://youtu.be/dQw4w9WgXcQ        # extracts YouTube transcript
necvk convert ./docs.md                           # processes local file
necvk convert <url> -o output.md                  # save to file
necvk convert <url> --method jina                 # force Jina Reader
necvk convert <url> --images                      # retain images in output

3-tier extraction — fastest successful tier wins:

1. Accept: text/markdown content negotiation (~0.1s)
2. Jina Reader API for SPAs, Medium, JS-heavy pages (~0.3s)
3. HTML fetch + markdown conversion (universal fallback)

forge — AI-powered skill generation

necvk forge <url|file>

# Examples
necvk forge https://react.dev/learn/hooks --key sk-xxx
necvk forge https://youtu.be/xyz --mode debug --provider groq --key gsk_xxx
necvk forge ./api-docs.md --mode api --stdout
necvk forge <url> --provider ollama --mode recipe   # local Ollama, no key needed

Providers: openai | openrouter | groq | minimax | ollama

Modes: howto (default) | debug | api | recipe | architecture

After forging, shows ready-to-paste install commands for Claude Code, Cursor, and Cline.

config — Save defaults

necvk config --key sk-xxx --provider openai
necvk config --show

Saves to ~/.nectarrc. Key priority: --key flag > OPENAI_API_KEY env > ~/.nectarrc.

providers / modes

necvk providers    # list all supported LLM providers
necvk modes        # list skill generation modes

Key Priority

1. --key <key> flag
2. Environment variable (OPENAI_API_KEY, GROQ_API_KEY, etc.)
3. ~/.nectarrc config file

License

MIT