Agent Skills

https://github.com/ypares/agent-skills
Admin
A comprehensive collection of self-contained AI agent skills organized as a Claude Plugin...
Tokens:108,911
Snippets:1,104
Trust Score:9.1
License:MIT
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### manifest.json example

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/profile-internals.md

Example of the manifest.json file that tracks installed packages, including flake inputs, attribute path, and store path.

```json
{
  "version": 6,
  "elements": [
    {
      "inputs": {
        "nixpkgs": {
          "id": "nixpkgs",
          "originalRef": "flake:nixpkgs",
          "lastModified": 1699300000,
          "narHash": "sha256-xxx..."
        }
      },
      "attrPath": "legacyPackages.x86_64-linux.git",
      "originalUrl": "flake:nixpkgs",
      "storePath": "/nix/store/xyz-git-2.42.0"
    }
  ]
}
```

--------------------------------

### User convention for profile setup

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/profile-internals.md

Common setup using ~/.nix-profile and exporting PATH to include the profile bin directory.

```bash
nix profile add --profile ~/.nix-profile "nixpkgs#git"
export PATH="$HOME/.nix-profile/bin:$PATH"
```

--------------------------------

### Start SearXNG with custom config

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/SKILL.md

Starts SearXNG with a custom configuration directory that must contain a settings.yml file.

```bash
start-searxng --config /path/to/your/config/dir
```

--------------------------------

### Usage Examples for Nushell Helpers

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/category-guide.md

These commands show how to call the Nushell helper functions with example arguments.

```nu
search-packages "express"
searx-cat "tokio" "cargo" --limit 5
searx-multi "docker" ["packages", "it", "repos"] --limit 10
```

--------------------------------

### Install and use qypi via uvx

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/pypi-direct-search.md

Install qypi on the fly with uvx and run its basic commands. Requires Python 3.10+.

```bash
uvx qypi search <term>
uvx qypi info <package>
```

--------------------------------

### pkg.go.dev search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'gin' using the pkg.go.dev engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=gin&format=json&engines=pkg.go.dev"
```

--------------------------------

### Flake Outputs Example

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/flakes.md

Example of a flake's outputs definition, showing packages, overlays, and modules.

```nix
{
  outputs = {
    packages.x86_64-linux.git = ...;      # Package for Linux x86_64
    packages.aarch64-darwin.python3 = ... # Package for macOS ARM
    overlays.default = ...;               # Overlay for custom modifications
    modules.default = ...;                # NixOS module
  };
}
```

--------------------------------

### Pinning Versions Example

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/flakes.md

Examples of pinning flake versions by tag, commit hash, and branch.

```bash
# By tag (recommended for stable)
github:user/repo/v1.0

# By commit hash (most reproducible)
github:user/repo/abc1234def5678

# By branch (least stable, not recommended)
github:user/repo/main
```

--------------------------------

### Registry Aliases Example

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/flakes.md

Examples of using registry aliases to reference flakes, resolving via the nix registry.

```bash
nixpkgs#git        # Resolves via nix registry
unstable#python3   # If configured as registry entry
```

--------------------------------

### Examples in Signatures

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/references/advanced-features.md

Adds an example to a command signature to show usage and expected result. The example uses the input-output type declaration and includes a result value with test data span.

```rust
use nu_protocol::Example;

fn signature(&self) -> Signature {
    Signature::build("my-command")
        .input_output_type(Type::String, Type::Int)
}

fn examples(&self) -> Vec<Example> {
    vec![
        Example {
            description: "Count characters in a string",
            example: "\"hello\" | my-command",
            result: Some(Value::int(5, Span::test_data())),
        },
    ]
}
```

--------------------------------

### Example output of nix registry list

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/registry.md

Example output of 'nix registry list', showing entries from system, global, and home scopes.

```text
system: flake:nixpkgs from git+ssh://git@github.com/nixos/nixpkgs
global flake:nixpkgs from github:nixos/nixpkgs (pinned to 699ba2a)
home flake:nixpkgs from git+ssh://git@github.com/... (if user added)
```

--------------------------------

### General workflow for installing a tool

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/SKILL.md

General workflow for installing a tool: determine the profile path (ask the user if AGENT_PROFILE is not set), search for the package, add it, then use the tool. The profile's bin directory must be in PATH.

```bash
# Determine profile path:
echo $AGENT_PROFILE  # If not defined, ask the user which profile to use!!

# Search for the package
nix search nixpkgs git

# Add it
nix profile add --profile "$AGENT_PROFILE" "nixpkgs#git"

# Just use it!
tool-cmd ...
```

--------------------------------

### Example TODO description for user authentication

Source: https://github.com/ypares/agent-skills/blob/main/jj-todo-workflow/SKILL.md

Example TODO description for implementing user authentication. It follows the recommended structure and includes specific requirements, implementation notes with references to existing code and specs, and testable acceptance criteria.

```markdown
Implement user authentication

## Context
Users need to log in to access their data. Using JWT tokens
for stateless auth.

## Requirements
- POST /auth/login accepts email + password
- Returns JWT token valid for 24h
- POST /auth/refresh extends token
- Invalid credentials return 401

## Implementation notes
- Use bcrypt for password hashing (see src/auth/admin.py::AdminLogin::hash_passwd which already uses it)
- Store refresh tokens in Redis
- See auth.md (#about-tokens) for token format spec

## Acceptance criteria
- All auth endpoints return correct status codes
- Tokens expire correctly
- Rate limiting prevents brute force
```

--------------------------------

### Manual container start with podman/docker

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/SKILL.md

Manually creates a minimal settings.yml and starts SearXNG with either podman or docker. The podman command uses the :Z volume flag for SELinux; the docker command does not. The container is named searxng and maps port 8888 to 8080.

```bash
# Create config
mkdir -p /tmp/searxng-config
cat > /tmp/searxng-config/settings.yml << 'EOF'
use_default_settings: true
search:
  formats:
    - html
    - json
server:
  secret_key: "change-me-in-production"
  bind_address: "0.0.0.0"
  port: 8080
EOF

# Start with podman
podman run --rm -d --name searxng \
  -p 8888:8080 \
  -v /tmp/searxng-config:/etc/searxng:Z \
  docker.io/searxng/searxng:latest

# Or with docker
docker run --rm -d --name searxng \
  -p 8888:8080 \
  -v /tmp/searxng-config:/etc/searxng \
  docker.io/searxng/searxng:latest
```

--------------------------------

### Flake URLs Example

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/flakes.md

Examples of flake references using git+https and file URLs.

```bash
git+https://github.com/user/repo.git    # Git URL
file:///home/user/my-flake              # Local path
```

--------------------------------

### pub.dev search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'flutter' using the pub.dev engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=flutter&format=json&engines=pub.dev"
```

--------------------------------

### npm search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'react' using the npm engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=react&format=json&engines=npm"
```

--------------------------------

### Install and register the plugin with Nushell

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/assets/plugin-template/README.md

Installs the plugin to the cargo bin directory and registers it with Nushell. On Windows, append .exe to the plugin path. The plugin is then loaded with `plugin use PLUGIN_NAME`.

```bash
# Install to cargo bin
cargo install --path . --locked

# Register with nushell
plugin add ~/.cargo/bin/nu_plugin_PLUGIN_NAME  # Add .exe on Windows
plugin use PLUGIN_NAME
```

--------------------------------

### Start and Task a Sub-agent with cursor-agent

Source: https://github.com/ypares/agent-skills/blob/main/cursor-agent-supervisor/SKILL.md

Use cursor-agent create-chat to create a conversation and get a UUID, then resume that conversation with a task description. The --print flag makes the sub-agent run independently and reply only when done.

```bash
# Create a conversation with a sub-agent:
cursor-agent --print --model <model-name> create-chat  # Prints a conversation uuid

# Give a task to the sub-agent: (command will finish when sub-agent is done)
cursor-agent --print --resume <conversation-uuid> "...description of the subagent's task..."
```

--------------------------------

### Release build and install plugin

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/references/testing-debugging.md

Builds an optimized release binary, installs it to the cargo bin directory, and adds it to Nushell from there. Note the Windows .exe suffix.

```bash
# Build optimized binary
cargo build --release

# Install to cargo bin directory
cargo install --path . --locked

# Add from cargo bin
plugin add ~/.cargo/bin/nu_plugin_myplugin  # Add .exe on Windows
plugin use myplugin
```

--------------------------------

### Safe search workflow for agents

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/package-search.md

A step-by-step workflow for agents to safely search and install packages. Includes searching, extracting pname, building full reference, verifying, and installing.

```bash
1. Always search before installing: `nix search <flake> <partial-name>`
2. Extract exact pname from JSON: `jq -r '.[] | .pname' | head -1`
3. Build full reference: `echo "<flake>#<pname>"`
4. Verify before install: `nix search <flake> "<pname>"` (verify exact match)
5. Install with full reference: `nix profile add --profile <path> "<flake>#<pname>"`
```

--------------------------------

### Build and install Nushell plugin

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/SKILL.md

Builds, installs, registers, and tests the Nushell plugin. The plugin add command expects the binary path; on Windows append .exe.

```bash
# Build
cargo build --release

# Install to cargo bin
cargo install --path . --locked

# Register with nushell
plugin add ~/.cargo/bin/nu_plugin_<name>  # Add .exe on Windows
plugin use <name>

# Test
"hello" | my-command
```

--------------------------------

### Hex search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'phoenix' using the hex engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=phoenix&format=json&engines=hex"
```

--------------------------------

### Void Linux packages search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'vim' using the voidlinux engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=vim&format=json&engines=voidlinux"
```

--------------------------------

### Start SearXNG container

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/README.md

Starts the SearXNG container in detached mode using the provided helper script. Requires podman or docker (auto-detected).

```bash
start-searxng --detach
```

--------------------------------

### Run the template with python app.py

Source: https://github.com/ypares/agent-skills/blob/main/textual-builder/assets/card-game-template/README.md

Use this command to start the card game template. Requires Textual and the app.py file in the current directory.

```bash
python app.py
```

--------------------------------

### qypi search command examples

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/pypi-direct-search.md

Search PyPI with qypi, supporting JSON output, boolean operators (--and, --or), and filtering by packages or releases.

```bash
# Search with JSON output
uvx qypi search pandas --json

# Search with boolean operators
uvx qypi search --and machine learning --json
uvx qypi search --or pandas numpy --json

# Search for packages or releases
uvx qypi search --packages scikit --json
uvx qypi search --releases torch --json
```

--------------------------------

### Automated test with PluginTest

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/SKILL.md

Example test module using PluginTest to run examples for a command. Requires the plugin and command to be in scope.

```rust
#[cfg(test)]
mod tests {
    use nu_plugin_test_support::PluginTest;

    #[test]
    fn test_command() -> Result<(), nu_protocol::ShellError> {
        PluginTest::new("myplugin", MyPlugin.into())?
            .test_examples(&MyCommand)
    }
}
```

--------------------------------

### Typst Example Workflow: Functions, State, and Data

Source: https://github.com/ypares/agent-skills/blob/main/typst-writer/SKILL.md

A complete Typst example showing how to define custom functions, use state for counters, and iterate over arrays. It demonstrates the correct syntax for arrays (using parentheses), content blocks (using square brackets), and the `#` prefix for code in markup context.

```typst
// Define custom functions for document elements
#let important(body) = {
  box(
    fill: red.lighten(80%),
    stroke: red + 1pt,
    inset: 8pt,
    body
  )
}

// Use state for counters
#let example-counter = state("examples", 1)

#let example(body) = context {
  let num = example-counter.get()
  important[Example #num: #body]
  example-counter.update(x => x + 1)
}

// Arrays for data
#let factions = (
  (name: "Merchants", color: blue),
  (name: "Artisans", color: green)
)

// Iterate and render
#for faction in factions [
  - #text(fill: faction.color, faction.name)
]
```

--------------------------------

### Alpine Linux packages search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'python' using the alpine linux packages engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=python&format=json&engines=alpine+linux+packages"
```

--------------------------------

### Docker Hub search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'nginx' using the docker hub engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=nginx&format=json&engines=docker+hub"
```

--------------------------------

### Handle multiple executables in installPhase

Source: https://github.com/ypares/agent-skills/blob/main/package-npm-nix/SKILL.md

Nix installPhase to install multiple executables from a package.json bin field, patching shebangs.

```nix
# package.json might have:
# "bin": {
#   "tool": "dist/cli.js",
#   "tool-admin": "dist/admin.js"
# }

installPhase = ''
  mkdir -p $out/bin
  for exe in tool tool-admin; do
    cp $src/dist/$exe.js $out/bin/$exe
    chmod +x $out/bin/$exe
    substituteInPlace $out/bin/$exe \
      --replace-quiet "#!/usr/bin/env node" "#!${nodejs}/bin/node"
  done
'';

meta.mainProgram = "tool";  # Primary command
```

--------------------------------

### Show start-searxng help

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/SKILL.md

Displays usage information for the start-searxng helper script, which creates a minimal SearXNG configuration automatically.

```bash
start-searxng --help
```

--------------------------------

### Dynamic Field Access in Nushell

Source: https://github.com/ypares/agent-skills/blob/main/nushell-usage/references/advanced-patterns.md

Shows how to access, update, and conditionally select fields using variable field names. The example uses 'get' and 'update' with a variable, and 'select' with a spread of a conditional list of fields.

```nu
# Access field by variable name
let field_name = "age"
$record | get $field_name

# Dynamic field update
let field_name = "status"
$record | update $field_name "active"

# Conditional field selection
let fields = if $detailed {["id", "name", "email"]} else {["id", "name"]}
$table | select ...$fields
```

--------------------------------

### qypi releases command

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/pypi-direct-search.md

List all available versions of a package.

```bash
uvx qypi releases flask --json
```

--------------------------------

### GitHub References Example

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/flakes.md

Examples of GitHub flake references for branches, commits, and tags.

```bash
github:user/repo               # Latest commit on default branch
github:user/repo/branch-name   # Specific branch
github:user/repo/commit-hash   # Specific commit
github:user/repo/v1.0.0        # Tag reference
```

--------------------------------

### Use qypi CLI to search and get package info

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/agent-usage.md

Use these uvx commands to search for packages and retrieve detailed information via the qypi CLI, which is a workaround for the non-functional PyPI engine.

```bash
uvx qypi search pandas --json
uvx qypi info requests --json
```

--------------------------------

### Get current directory with get_current_dir

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/references/advanced-features.md

Get the current directory from the engine and join a filename to build a file path.

```rust
let current_dir = engine.get_current_dir()?;
let file_path = current_dir.join("data.json");
```

--------------------------------

### Build and test the package

Source: https://github.com/ypares/agent-skills/blob/main/package-npm-nix/SKILL.md

Commands to build, test, check dependencies, format, and run flake checks.

```bash
# Build
nix build .#tool-name

# Test the binary
./result/bin/tool-name --version
./result/bin/tool-name --help

# Check dependencies (Linux)
ldd ./result/bin/tool-name  # Should show all deps resolved

# Format
nix fmt

# Run flake checks
nix flake check
```

--------------------------------

### qypi info command

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/pypi-direct-search.md

Retrieve comprehensive package information including author, license, URLs, dependencies, and classifiers.

```bash
uvx qypi info requests --json
```

--------------------------------

### MetaCPAN search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'mojolicious' using the metacpan engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=mojolicious&format=json&engines=metacpan"
```

--------------------------------

### Packagist search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'laravel' using the packagist engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=laravel&format=json&engines=packagist"
```

--------------------------------

### RubyGems search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'sinatra' using the rubygems engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=sinatra&format=json&engines=rubygems"
```

--------------------------------

### Basic citation and bibliography setup in Typst

Source: https://github.com/ypares/agent-skills/blob/main/typst-writer/references/bibliography.md

Shows how to cite sources in a Typst document using @label syntax and how to render the bibliography with the #bibliography function. Place the #bibliography call at the end of the document.

```typst
// In your document, cite with @label
Some text with a citation @smith2023.
Multiple citations @jones2024 @doe2025.

// At the end of your document
#bibliography("references.bib", title: "References", style: "ieee")
```

--------------------------------

### crates.io search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'serde' using the crates.io engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=serde&format=json&engines=crates.io"
```

--------------------------------

### Hoogle search example (curl)

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/package-engine-status.md

Example curl command to search for 'lens' using the hoogle engine on a local SearXNG instance.

```bash
curl -s "http://localhost:8888/search?q=lens&format=json&engines=hoogle" | jq .
```

--------------------------------

### Use qypi CLI for PyPI search, info, and releases

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/SKILL.md

qypi CLI tool commands for searching packages, getting package info, and listing releases. Each command outputs JSON and is run via uvx.

```bash
uvx qypi search pandas --json
```

```bash
uvx qypi info requests --json
```

```bash
uvx qypi releases flask --json
```

--------------------------------

### Start SearXNG on custom port

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/SKILL.md

Starts SearXNG on a custom port (9999) in detached mode. Overrides the default port 8888.

```bash
start-searxng --port 9999 --detach
```

--------------------------------

### Type selectors for Button and Label

Source: https://github.com/ypares/agent-skills/blob/main/textual-builder/references/styling.md

Targets all widgets of a type. Button gets full width, Label gets cyan text.

```css
Button {
    width: 100%;
}

Label {
    color: cyan;
}
```

--------------------------------

### Using registry aliases vs full URLs

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/registry.md

Shows the difference between using a full flake URL and a registry alias. The first command uses the full URL, while the second and third use the 'nixpkgs' alias.

```bash
# Without registry (full URL)
nix profile add --profile ~/profile github:nixos/nixpkgs/nixpkgs-unstable#git

# With registry alias
nix search nixpkgs git  # "nixpkgs" is a registry alias
nix profile add --profile ~/profile nixpkgs#git
```

--------------------------------

### Source build with Bun and fetchBunDeps derivation

Source: https://github.com/ypares/agent-skills/blob/main/package-npm-nix/SKILL.md

Nix derivation for building a tool from source with Bun. It defines a fetchBunDeps helper to fetch and hash node_modules, then builds with bun run build, patches binaries, and sets fromSource provenance. Requires a bun.lock file and uses autoPatchelfHook for native binaries.

```nix
{
  lib,
  stdenv,
  stdenvNoCC,
  fetchFromGitHub,
  bun,
  makeBinaryWrapper,
  nodejs,
  autoPatchelfHook,
}:

let
  fetchBunDeps =
    { src, hash, ... }@args:
    stdenvNoCC.mkDerivation {
      pname = args.pname or "${src.name or "source"}-bun-deps";
      version = args.version or src.version or "unknown";
      inherit src;

      nativeBuildInputs = [ bun ];

      buildPhase = ''
        export HOME=$TMPDIR
        export npm_config_ignore_scripts=true
        bun install --no-progress --frozen-lockfile --ignore-scripts
      '';

      installPhase = ''
        mkdir -p $out
        cp -R ./node_modules $out
        cp ./bun.lock $out/
      '';

      dontFixup = true;
      outputHash = hash;
      outputHashAlgo = "sha256";
      outputHashMode = "recursive";
    };

  version = "1.0.0";
  src = fetchFromGitHub {
    owner = "org";
    repo = "repo";
    rev = "v${version}";
    hash = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=";
  };

  node_modules = fetchBunDeps {
    pname = "tool-name-bun-deps";
    inherit version src;
    hash = "sha256-BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB=";
  };
in
stdenv.mkDerivation rec {
  pname = "tool-name";
  inherit version src;

  nativeBuildInputs = [
    bun
    nodejs
    makeBinaryWrapper
    autoPatchelfHook
  ];

  buildInputs = [
    stdenv.cc.cc.lib
  ];

  buildPhase = ''
    # Verify lockfile match
    diff -q ./bun.lock ${node_modules}/bun.lock || exit 1

    # Copy and patch node_modules
    cp -R ${node_modules}/node_modules .
    chmod -R u+w node_modules
    patchShebangs node_modules
    autoPatchelf node_modules

    export HOME=$TMPDIR
    export npm_config_ignore_scripts=true
    bun run build
  '';

  installPhase = ''
    mkdir -p $out/bin
    cp dist/tool-name $out/bin/tool-name
    chmod +x $out/bin/tool-name
  '';

  dontStrip = true;

  meta = with lib; {
    description = "Tool description";
    homepage = "https://github.com/org/repo";
    license = licenses.mit;
    sourceProvenance = with lib.sourceTypes; [ fromSource ];
    maintainers = with maintainers; [ ];
    mainProgram = "tool-name";
    platforms = [ "x86_64-linux" ];
  };
}
```

--------------------------------

### Class selectors for .card and .selected

Source: https://github.com/ypares/agent-skills/blob/main/textual-builder/references/styling.md

Targets widgets with specific classes. .card gets border and padding, .selected gets yellow background.

```css
.card {
    border: round white;
    padding: 1;
}

.selected {
    background: yellow;
}
```

--------------------------------

### Basic search for a package

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/package-search.md

Searches package names and descriptions in the nixpkgs flake. Returns multiple results if any match.

```bash
nix search nixpkgs git
```

--------------------------------

### Pre-built npm package derivation with fetchzip and hash commands

Source: https://github.com/ypares/agent-skills/blob/main/package-npm-nix/SKILL.md

Nix derivation for a pre-built npm package using fetchzip, plus commands to fetch and convert the hash to SRI format. The derivation copies the built CLI from dist/, fixes the shebang, and sets metadata with binaryBytecode provenance.

```nix
{
  lib,
  stdenv,
  fetchzip,
  nodejs,
}:

stdenv.mkDerivation rec {
  pname = "tool-name";
  version = "1.0.0";

  src = fetchzip {
    url = "https://registry.npmjs.org/${pname}/-/${pname}-${version}.tgz";
    hash = "sha256-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=";
  };

  nativeBuildInputs = [ nodejs ];

  installPhase = ''
    runHook preInstall

    mkdir -p $out/bin
    cp $src/dist/cli.js $out/bin/tool-name
    chmod +x $out/bin/tool-name

    # Fix shebang
    substituteInPlace $out/bin/tool-name \
      --replace-quiet "#!/usr/bin/env node" "#!${nodejs}/bin/node"

    runHook postInstall
  '';

  meta = with lib; {
    description = "Tool description";
    homepage = "https://github.com/org/repo";
    license = licenses.mit;
    sourceProvenance = with lib.sourceTypes; [ binaryBytecode ];
    maintainers = with maintainers; [ ];
    mainProgram = "tool-name";
    platforms = platforms.all;
  };
}
```

```bash
nix-prefetch-url --unpack https://registry.npmjs.org/tool-name/-/tool-name-1.0.0.tgz
# Convert to SRI format:
nix hash convert --to sri --hash-algo sha256 <hash-output>
```

--------------------------------

### Install Textual with pip or uv

Source: https://github.com/ypares/agent-skills/blob/main/textual-builder/SKILL.md

Install the Textual library using pip or uv. The current version is v0.86.0+ (as of November 2025, latest is v6.6.0).

```bash
pip install textual
# or
uv pip install textual
```

--------------------------------

### Type Coercion Rules and Examples

Source: https://github.com/ypares/agent-skills/blob/main/nushell-usage/references/type-system.md

Shows that auto-coercion only happens in string interpolations. Includes examples of type errors, explicit conversions with 'into', and type-safe comparisons.

```nu
# NO
"5" + 3                 # TYPE ERROR

# YES
$"Value: (42)"          # "Value: 42"

# YES
"5" + (3 | into string) # "53"

# Boolean to int
true | into int         # 1
false | into int        # 0

# Be explicit when precision matters
let x = ("3.14" | into float)
let y = ("2.0" | into float)
$x + $y

# Type-safe comparisons
42 == "42"            # false (different types)
42 == ("42" | into int)  # true
```

--------------------------------

### Build and test plugin locally

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/references/testing-debugging.md

Builds the plugin in debug mode, adds it to Nushell, loads it, and tests the command with a sample input.

```bash
# Build the plugin
cargo build

# Add to nushell (debug build)
plugin add target/debug/nu_plugin_myplugin

# Load the plugin
plugin use myplugin

# Test the command
"test input" | myplugin
```

--------------------------------

### Choose serializer in main() with serve_plugin

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/references/plugin-protocol.md

Choose the serializer in main() by passing either MsgPackSerializer (recommended for production) or JsonSerializer (for debugging) to serve_plugin().

```rust
use nu_plugin::{MsgPackSerializer, serve_plugin};

fn main() {
    serve_plugin(&MyPlugin, MsgPackSerializer)  // Production
    // serve_plugin(&MyPlugin, JsonSerializer)  // Debug
}
```

--------------------------------

### Define actions with key bindings

Source: https://github.com/ypares/agent-skills/blob/main/textual-builder/references/interactivity.md

Shows how to define an App with BINDINGS and action methods. Pressing 'n' or 'p' triggers the corresponding action to change pages and refresh the view.

```python
class MyApp(App):
    BINDINGS = [
        ("n", "next_page", "Next"),
        ("p", "prev_page", "Previous"),
    ]

    def action_next_page(self) -> None:
        self.page += 1
        self.refresh_view()

    def action_prev_page(self) -> None:
        self.page -= 1
        self.refresh_view()
```

--------------------------------

### Start SearXNG if not running

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/agent-usage.md

Checks if SearXNG is running on localhost:8888 and starts it in detached mode if not. Use at the beginning of a search-intensive task, when package searches are requested, or when WebSearch results are insufficient.

```bash
# Check if running
curl -sf http://localhost:8888/ > /dev/null || \
  start-searxng --detach
```

--------------------------------

### Mounting Widgets Dynamically

Source: https://github.com/ypares/agent-skills/blob/main/textual-builder/references/basics.md

Shows how to dynamically add widgets after the app starts using mount(), which returns a coroutine and must be awaited. Also demonstrates modifying an existing widget's label.

```python
async def on_key(self) -> None:
    # Must await when modifying mounted widgets
    await self.mount(NewWidget())
    self.query_one(Button).label = "Modified!"
```

--------------------------------

### Check if SearXNG is running and start if needed

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/agent-usage.md

Use this shell snippet to ensure SearXNG is running before making queries. It checks the health endpoint and starts the service in detached mode if it is not responding.

```bash
if ! curl -sf http://localhost:8888/ > /dev/null 2>&1; then
  echo "Starting SearXNG..."
  start-searxng --detach
fi
```

--------------------------------

### Dynamic registry for development

Source: https://github.com/ypares/agent-skills/blob/main/nix-profile-manager/references/registry.md

Instead of modifying the global registry, create a local flake.nix and use nix flake init, nix flake update, and nix profile add to install the local flake in a profile.

```bash
cd ~/myproject
nix flake init

# Edit flake.nix, then:
nix flake update

# Then install the local flake in a profile:
nix profile add "~/myproject#packages.x86_64-linux.mytool"
```

--------------------------------

### Code Examples Search: Filter GitHub Results for Rust Async/Await

Source: https://github.com/ypares/agent-skills/blob/main/searxng-search/references/agent-usage.md

Use this curl command to search for code examples of async/await in Rust. It queries the 'code' category and filters results to only those from GitHub, extracting title and URL.

```bash
curl -s "http://localhost:8888/search?q=rust+async+await&format=json&categories=code" | \
  jq '.results[] | select(.engines[] == "github") | {title, url}'
```

--------------------------------

### GitHub Actions Workflow for Testing and Building

Source: https://github.com/ypares/agent-skills/blob/main/nushell-plugin-builder/references/testing-debugging.md

This workflow runs tests and builds the plugin on push and pull requests. It checks out the code, sets up the Rust toolchain, runs tests, builds the release binary, and verifies the binary exists.

```yaml
name: Test Plugin

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - name: Run tests
        run: cargo test
      - name: Build release
        run: cargo build --release
      - name: Check binary exists
        run: test -f target/release/nu_plugin_myplugin
```

--------------------------------

### Filesizes: literals and math

Source: https://github.com/ypares/agent-skills/blob/main/nushell-usage/references/type-system.md

Shows filesize literals, conversion from integer, and arithmetic operations on filesizes.

```nu
# File sizes
1kb, 500mb, 2gb, 1tb
1024 | into filesize  # 1kb

# Filesize math
100mb + 50mb          # 150mb
1gb / 4               # 250mb
```

--------------------------------

### Handle WASM files or other assets in installPhase

Source: https://github.com/ypares/agent-skills/blob/main/package-npm-nix/SKILL.md

Nix installPhase to copy WASM files and patch the shebang for a Bun-compiled CLI.

```nix
installPhase = ''
  mkdir -p $out/bin
  cp $src/dist/cli.js $out/bin/tool
  cp $src/dist/*.wasm $out/bin/  # Copy WASM alongside
  chmod +x $out/bin/tool

  substituteInPlace $out/bin/tool \
    --replace-quiet "#!/usr/bin/env node" "#!${nodejs}/bin/node"
'';
```

--------------------------------

### Real-World Example: Replace Line Numbers with Typst Labels

Source: https://github.com/ypares/agent-skills/blob/main/working-with-jj/references/batch-operations.md

Real-world example replacing line number references with Typst labels across 10 revisions. Creates a sed replacement script, processes each revision, and verifies one result.

```bash
cat > /tmp/sed_replacements.txt << 'EOF'
s/5F\.typ L596-617/5F.typ @types-de-cartes/g
s/5F\.typ L1242-1253/5F.typ @carte-eglise-en-pierre/g
s/5F\.typ L659-665/5F.typ @couts-marche/g
# ... etc
EOF

# 2. Process each revision
for rev in unxn mktt stnq rwyq roww wltq syun zkru mszz ovrv; do
  jj log -r "$rev" -n1 --no-graph -T description | \
    sed -f /tmp/sed_replacements.txt > "/tmp/desc_${rev}_new.txt"
  jj desc -r "$rev" --stdin < "/tmp/desc_${rev}_new.txt"
done

# 3. Verify one result
jj log -r mktt -n1 --no-graph -T description | head -5
```
Tokens:
Raw