Agent skill

Stalker Portal

by 4gray in 4gray/iptvnator

A skill your agent uses when changing Stalker or Ministra routes, stores, catalog or series shapes, playback progress, favorites and recent items, EPG, or remote control.

MITAuto-check passed

Install Stalker Portal

skills CLI
$ npx skills add 4gray/iptvnator --skill stalker-portal -a claude-code

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

GitHub CLI
$ gh skill install 4gray/iptvnator stalker-portal --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/4gray/iptvnator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/stalker-portal .claude/skills/stalker-portal && 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
stalker-portal
GitHub stars
7.3k
Token cost
~990 tokens
SKILL.md length
449 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when changing Stalker or Ministra routes, stores, catalog or series shapes, playback progress, favorites and recent items, EPG, or remote control.

  • Changing Stalker
  • SKILL.md covers Read First, Ownership, Portal Mode And Session and Series Contract, plus 2 more sections
  • Calls pnpm
  • Ministra routes

What it does

Stalker Portal is an agent skill from 4gray/iptvnator. Use when changing Stalker or Ministra routes, stores, catalog or series shapes, playback progress, favorites and recent items, EPG, or remote control.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: :tv: Cross-platform IPTV player application with multiple features, such as support of m3u and m3u8 playlists, favorites, TV guide, TV archive/catchup and more. The licence is MIT.

When your agent uses it

  • Changing Stalker
  • Ministra routes
  • Playback progress
  • Favorites and recent items

Example prompts

  • “/stalker-portal”

What it can do on your machine

Read from SKILL.md and the folder at commit 015ea20. 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

    Shell commands in SKILL.md call:

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Stalker Portal loads about 990 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 449 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from 4gray/iptvnator at commit 015ea20, republished under its MIT licence (© 4gray). 449 words, ~990 tokens.

Download SKILL.mdSave it as .claude/skills/stalker-portal/SKILL.md (or your agent's skills folder).
name
stalker-portal
description
Use when changing Stalker or Ministra routes, stores, catalog or series shapes, playback progress, favorites and recent items, EPG, or remote control.

Stalker Portal

Read First

  • docs/architecture/stalker-portal.md
  • docs/architecture/stalker-epg.md for ITV EPG
  • docs/architecture/remote-control.md for live remote control

Ownership

  • Routed UI: libs/portal/stalker/feature/src/lib/
  • Session, store, and normalization: libs/portal/stalker/data-access/src/lib/
  • Wire-format and identity contracts: libs/shared/interfaces/src/lib/ — portal-mode predicate, MAC/device-ID utils, auth-failure classifier, cmd encoder, URL/identity builders. There because Electron main cannot import renderer libs; never fork them.
  • Electron transport: apps/electron-backend/src/app/events/stalker.events.ts
  • Provider-neutral collections: libs/portal/shared/data-access/src/lib/

Keep Stalker shape and store rules in Stalker data access. Shared portal UI must remain provider-neutral.

Portal Mode And Session

Full vs. simple mode is decided by observed behavior, not URL shape, and read only through isFullStalkerPortalPlaylist(). Route playlist-backed catalog, content and playback calls through executeStalkerRequest(). Auth, discovery, account-profile refresh and row-less collection resolution go direct; read stalker-request.utils.ts before adding a fifth. Repair is lazy per session, never eager. Full portals reuse the persisted idempotent handshake token while its session fingerprint matches, and ping get_events at the profile cadence (default 120 s). Auth failures are HTTP 200 plus plain text.

Series Contract

Inside Stalker portal code, isStalkerSeriesFlag() is the canonical predicate and accepts exactly true, 1, and '1'. normalizeStalkerSeriesFlag() delegates to it and produces the normalized positive marker true or undefined. The activity normalizer in shared interfaces keeps its dependency-neutral equivalent for favorites/recent and dashboard classification. Preserve all three modes: regular /series, VOD with embedded series[], and lazy Ministra VOD is_series.

Favorites/recent preserve the normalized positive marker and VOD origin so reopening still uses the correct lazy or embedded mode. Keep quick-start translation parameters and the naturally ordered season fallback when season_number is absent.

Lazy episodes use a deterministic tracking ID scoped by parent series, provider episode, season key, and episode number. legacyTrackingId is only a guarded compatibility alias. Reconciliation is limited to the current parent series and optional matching season/episode metadata; an exact scoped row always wins the resolved display position, while a compatible legacy row may remain tracked only for cleanup. The scoped ID is the in-memory key. At the strict migration boundary, save the scoped row before clearing a confirmed legacy row, and keep legacy progress when the save fails.

Show full SKILL.md (111 more words)Show less

Before inline or external handoff, attach parent seriesXtreamId and resolved season/episode numbers. Keep them on subsequent position writes.

Live Contract

  • Start bulk ITV EPG eagerly once channel rows exist. Rows read the bulk cache, falling back to throttled get_short_epg previews when it lacks "now".
  • Radio skips EPG and external players, preserves live collection identity with radio: 'true', and uses the shared inline audio player.

Validation

Run:

  • pnpm nx test shared-interfaces
  • pnpm nx test portal-stalker-data-access
  • pnpm nx test portal-stalker-feature
  • the affected portal-shared-data-access / portal-shared-ui target for collection or radio behavior
  • the affected workspace-dashboard-data-access and workspace-dashboard-feature test targets

For the user workflow, run pnpm nx run web-e2e:e2e-ci--src/stalker.e2e.ts or document the strongest focused coverage available.

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

Files

Just SKILL.md in .codex/skills/stalker-portal of 4gray/iptvnator.

Open the folder on GitHubat commit 015ea20

Compare with similar skills

Stalker Portal 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.

Stalker Portal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Stalker Portal this skill4gray/iptvnator7.3k—~990Automated safety check: PassMIT
WooCommerce Store API Routeswoocommerce/woocommerce11k—~932Automated safety check: PassCustom licence
Agent App Storeruvnet/ruflo74k2 repos~1kAutomated safety check: PassMIT
OmniRoute Routing CLIdiegosouzapw/OmniRoute75k—~342Automated safety check: PassMIT
OmniRoute Combo Routingdiegosouzapw/OmniRoute75k—~2.1kAutomated safety check: PassMIT
App Store Optimizationalirezarezvani/claude-skills28k1 repos~4.2kAutomated safety check: PassMIT

Similar skills

  • WooCommerce Store API Routes

    woocommerce/woocommerce

    Guidelines for adding or changing routes in the WooCommerce Store API under /wc/store/v1, covering authentication, REST design, schemas and variations.

    11k GitHub stars~932 tokensUpdated today
    Backend & APIsAuto-check passed
  • Agent App Store

    ruvnet/ruflo

    Agent skill for app-store - invoke with $agent-app-store. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 2 repos~1k tokens
    MobileAuto-check passed
  • OmniRoute Routing CLI

    diegosouzapw/OmniRoute

    Creates, switches, and inspects OmniRoute model-routing combos, plus a suggestion command with cost and latency constraints.

    75k GitHub stars~342 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • OmniRoute Combo Routing

    diegosouzapw/OmniRoute

    Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics.

    75k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Intelligence Route

    ruvnet/ruflo

    Route tasks via the 3-tier model selector and learned patterns; emits a routing rationale via hooksexplain

    74k GitHub stars~874 tokensUpdated today
    DevelopmentAuto-check: notes

More from 4gray/iptvnator

All 8 skills in this repo
  • A skill your agent uses when deciding where IPTVnator code belongs, creating or moving Nx projects, changing scoped aliases or tags, editing lint targets, or validating module boundaries.

    7.3k GitHub stars~828 tokensUpdated today
    Auto-check passed
  • A skill your agent uses when changing Electron SQLite IPC, database-worker operations, request-scoped progress or cancellation, worker packaging, or runtime verification of non-EPG database work.

    7.3k GitHub stars~824 tokensUpdated today
    Auto-check passed
  • Release Cut

    4gray/iptvnator

    A skill your agent uses when preparing, cutting, tagging, publishing, or verifying an IPTVnator release or its release assets.

    7.3k GitHub stars~929 tokensUpdated today
    Auto-check passed
  • Release Notes

    4gray/iptvnator

    A skill your agent uses when a change may need a .changes note, the Release note gate fails, or deciding whether type: internal or no-release-note applies.

    7.3k GitHub stars~446 tokensUpdated today
    Auto-check passed
  • Iptvnator Theme Style

    4gray/iptvnator

    A skill your agent uses when changing IPTVnator SCSS tokens, shared layout mixins, portal headers, sidebars, detail views, Electron drag regions, or cross-portal visual consistency.

    7.3k GitHub stars~983 tokensUpdated today
    Auto-check passed
  • Iptvnator UI Design

    4gray/iptvnator

    A skill your agent uses when changing user-visible Angular UI in IPTVnator, especially channel rows or lists, EPG views, settings and playlist surfaces, selection states, shared portal components…

    7.3k GitHub stars~568 tokensUpdated today
    Auto-check passed

Questions about Stalker Portal

What does Stalker Portal do?

A skill your agent uses when changing Stalker or Ministra routes, stores, catalog or series shapes, playback progress, favorites and recent items, EPG, or remote control. Stalker Portal is an agent skill from 4gray/iptvnator. Use when changing Stalker or Ministra routes, stores, catalog or series shapes, playback progress, favorites and recent items, EPG, or remote control.

When should I use Stalker Portal?

Stalker Portal fits situations like: changing Stalker; ministra routes; playback progress; favorites and recent items.

How do I install Stalker Portal in Claude Code?

Run `npx skills add 4gray/iptvnator --skill stalker-portal -a claude-code`. Or copy the skill folder (.codex/skills/stalker-portal in 4gray/iptvnator) into .claude/skills/stalker-portal in your project. Claude Code loads it when a task matches its description.

How do I install Stalker Portal in Codex?

Run `npx skills add 4gray/iptvnator --skill stalker-portal -a codex`. Or copy the skill folder (.codex/skills/stalker-portal in 4gray/iptvnator) into .agents/skills/stalker-portal in your project. Codex loads it when a task matches its description.

Can I use Stalker Portal 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 4gray/iptvnator --skill stalker-portal -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/stalker-portal, .gemini/skills/stalker-portal, .github/skills/stalker-portal and .opencode/skills/stalker-portal in your project.

What does Stalker Portal need to run?

Going by SKILL.md and its folder, Stalker Portal needs the command-line tools its instructions call (pnpm).

Does Stalker Portal 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 Stalker Portal 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. Review the folder before installing.

What licence does Stalker Portal use?

Stalker Portal 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 Stalker Portal 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.

What are the alternatives to Stalker Portal?

Skills that share tags, products or a category with Stalker Portal: WooCommerce Store API Routes (woocommerce/woocommerce, 11k stars), Agent App Store (ruvnet/ruflo, 74k stars), OmniRoute Routing CLI (diegosouzapw/OmniRoute, 75k stars) and OmniRoute Combo Routing (diegosouzapw/OmniRoute, 75k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Stalker Portal?

4gray (a GitHub user) maintains it in 4gray/iptvnator, which has 7,318 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 10, 2026.

Source: 4gray/iptvnator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.