Agent skill

Architecture

by jj1bdx in jj1bdx/airspy-fmradion

Architecture of airspy-fmradion — signal flow from SDR source to audio output, key type aliases, the Source abstraction, and the FM decoder pipeline.

GPL-3.0Auto-check passed

Install Architecture

skills CLI
$ npx skills add jj1bdx/airspy-fmradion --skill architecture -a claude-code

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

GitHub CLI
$ gh skill install jj1bdx/airspy-fmradion architecture --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/jj1bdx/airspy-fmradion.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/architecture .claude/skills/architecture && 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
architecture
GitHub stars
168
Token cost
~588 tokens
SKILL.md length
154 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
GPL-3.0

At a glance

Architecture of airspy-fmradion — signal flow from SDR source to audio output, key type aliases, the Source abstraction, and the FM decoder pipeline.

  • Works in 7 steps: Optional IQ bandpass filter… → IF AGC (IfSimpleAgc) → Optional multipath filter… → …
  • Modifying the DSP chain
  • SKILL.md covers Signal flow, Key type aliases…, Source abstraction and FM decoder pipeline…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Architecture is an agent skill from jj1bdx/airspy-fmradion. Architecture of airspy-fmradion — signal flow from SDR source to audio output, key type aliases, the Source abstraction, and the FM decoder pipeline. Use when reading or modifying the DSP chain, sources, decoders, buffers, or audio output.

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

It works with Linux and macOS. The repository describes itself as: Software decoder for FM/AM broadcast radio with AirSpy R2 / Mini, Airspy HF+, and RTL-SDR. The licence is GPL-3.0.

When your agent uses it

  • Modifying the DSP chain

Example prompts

  • “/architecture”

Workflow steps

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

  1. Optional IQ bandpass filter (LowPassFilterFirIQ)
  2. IF AGC (IfSimpleAgc)
  3. Optional multipath filter (MultipathFilter — normalized LMS, enabled
  4. Phase discriminator → baseband
  5. Audio resampler (r8brain via AudioResampler)
  6. Pilot PLL for stereo detection (PilotPhaseLock, also generates PPS
  7. Stereo L−R demodulation, de-emphasis, DC blocking

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Architecture loads about 588 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 154 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
~588

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 jj1bdx/airspy-fmradion at commit 869753f, republished under its GPL-3.0 licence (© jj1bdx). 154 words, ~588 tokens.

Download SKILL.mdSave it as .claude/skills/architecture/SKILL.md (or your agent's skills folder).
name
architecture
description
Architecture of airspy-fmradion — signal flow from SDR source to audio output, key type aliases, the Source abstraction, and the FM decoder pipeline. Use when reading or modifying the DSP chain, sources, decoders, buffers, or audio output.

Architecture

Signal flow

SDR hardware / file
    ↓
Source subclass (AirspySource / AirspyHFSource / RtlSdrSource / FileSource)
    ↓  [separate thread, pushes IQSampleVector]
DataBuffer<IQSample>  ← thread-safe queue with condition variable
    ↓  [main thread pulls]
FourthConverterIQ     ← Fs/4 downconversion for zero-IF devices (Airspy HF+, RTL-SDR)
    ↓
IfResampler           ← r8brain-based rational resampler to decoder's target rate
    ↓
FmDecoder / AmDecoder / NbfmDecoder
    ↓  [SampleVector at 48 kHz]
AudioOutput (SndfileOutput or PortAudioOutput)

Key type aliases (include/SoftFM.h)

AliasUnderlying typeUse
IQSamplestd::complex<float>Raw IF samples
IQSampleVectorstd::vector<IQSample>Block of IF samples
IQSampleDecodedfloatPhase-discriminated baseband sample
SampledoubleAudio sample
SampleVectorstd::vector<double>Audio block
IQSampleCoeffstd::vector<float>FIR filter coefficients for IQ path

Enums also live in SoftFM.h: FilterType, DevType, ModType, OutputMode, PilotState.

Source abstraction

All SDR frontends implement the abstract Source interface (include/Source.h):

  • configure(string) — parse key=value config string and open device
  • start(DataBuffer<IQSample>*, atomic_bool*) — begin streaming in a background thread
  • stop() / is_low_if() / get_sample_rate() / get_frequency()

Low-IF sources (Airspy R2/Mini output real low-IF, not zero-IF) skip the FourthConverterIQ step — controlled by is_low_if().

FM decoder pipeline (sfmbase/FmDecode.cpp)

Inside FmDecoder::process():

  1. Optional IQ bandpass filter (LowPassFilterFirIQ)
  2. IF AGC (IfSimpleAgc)
  3. Optional multipath filter (MultipathFilter — normalized LMS, enabled with -E)
  4. Phase discriminator → baseband
  5. Audio resampler (r8brain via AudioResampler)
  6. Pilot PLL for stereo detection (PilotPhaseLock, also generates PPS events)
  7. Stereo L−R demodulation, de-emphasis, DC blocking

© jj1bdx, GPL-3.0. 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 .claude/skills/architecture of jj1bdx/airspy-fmradion.

Open the folder on GitHubat commit 869753f

Compare with similar skills

Architecture 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.

Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Architecture this skilljj1bdx/airspy-fmradion168—~588Automated safety check: PassGPL-3.0
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
Native Feel Cross Platform Desktopyetone/native-feel-skill1.9k1 repos~1.5kAutomated safety check: PassMIT
TreeSheets Agent Socketaardappel/treesheets3.2k—~5.7kAutomated safety check: NotesZlib

Similar skills

  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • Native Feel Cross Platform Desktop

    yetone/native-feel-skill

    A skill your agent uses when the user is designing, prototyping, or rewriting a desktop app that must run on multiple OSes (macOS + Windows, optionally Linux) AND feel indistinguishable from a…

    1.9k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • TreeSheets Agent Socket

    aardappel/treesheets

    Runs Lobster scripts against the document open in a running TreeSheets instance through its local agent socket, and returns the results or errors.

    3.2k GitHub stars~5.7k tokensUpdated today
    Productivity & AutomationAuto-check: notes
  • Open Computer Use

    iFurySt/open-codex-computer-use

    Platform-neutral guidance for using Open Computer Use, the open-source Computer Use MCP server and CLI for macOS, Linux, and Windows.

    2.4k GitHub stars~1.5k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed

More from jj1bdx/airspy-fmradion

  • Format

    jj1bdx/airspy-fmradion

    Format airspy-fmradion sources with clang-format and cmake-format.

    168 GitHub stars~125 tokensUpdated 9 days ago
    Auto-check passed

Works with

Questions about Architecture

What does Architecture do?

Architecture of airspy-fmradion — signal flow from SDR source to audio output, key type aliases, the Source abstraction, and the FM decoder pipeline. Architecture is an agent skill from jj1bdx/airspy-fmradion. Architecture of airspy-fmradion — signal flow from SDR source to audio output, key type aliases, the Source abstraction, and the FM decoder pipeline.

When should I use Architecture?

Architecture fits situations like: modifying the DSP chain.

How do I install Architecture in Claude Code?

Run `npx skills add jj1bdx/airspy-fmradion --skill architecture -a claude-code`. Or copy the skill folder (.claude/skills/architecture in jj1bdx/airspy-fmradion) into .claude/skills/architecture in your project. Claude Code loads it when a task matches its description.

How do I install Architecture in Codex?

Run `npx skills add jj1bdx/airspy-fmradion --skill architecture -a codex`. Or copy the skill folder (.claude/skills/architecture in jj1bdx/airspy-fmradion) into .agents/skills/architecture in your project. Codex loads it when a task matches its description.

Can I use Architecture 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 jj1bdx/airspy-fmradion --skill architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/architecture, .gemini/skills/architecture, .github/skills/architecture and .opencode/skills/architecture in your project.

What does Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Architecture is instructions for the agent only.

Does Architecture 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 Architecture 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 Architecture use?

Architecture is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Architecture use?

About 588 tokens (SKILL.md is roughly 2.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 Architecture?

Skills that share tags, products or a category with Architecture: Engine Whats New (flutter/flutter, 179k stars), Openclaw Live Updater (openclaw/openclaw, 392k stars), Apple Container Test Runner (RustPython/RustPython, 22k stars) and Native Feel Cross Platform Desktop (yetone/native-feel-skill, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Architecture?

jj1bdx (a GitHub user) maintains it in jj1bdx/airspy-fmradion, which has 168 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 30, 2026.

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