Agent skill

Source Command Unifi MCP Add Tool

by enuno in enuno/unifi-mcp-server

Scaffold a new UniFi MCP tool with model, function, tests, and docs

Apache-2.0Auto-check passedAgent Workflows

Install Source Command Unifi MCP Add Tool

skills CLI
$ npx skills add enuno/unifi-mcp-server --skill source-command-unifi-mcp-add-tool -a claude-code

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

GitHub CLI
$ gh skill install enuno/unifi-mcp-server source-command-unifi-mcp-add-tool --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/enuno/unifi-mcp-server.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/source-command-unifi-mcp-add-tool .claude/skills/source-command-unifi-mcp-add-tool && 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
source-command-unifi-mcp-add-tool
GitHub stars
282
Token cost
~748 tokens
SKILL.md length
313 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Scaffold a new UniFi MCP tool with model, function, tests, and docs

  • Works in 7 steps: Ask the user for tool details → Create or update the Pydantic model in… → Create the tool function in src/tools/ → …
  • Tasks that involve MCP servers
  • Calls black, pytest and python

What it does

Source Command Unifi MCP Add Tool is an agent skill from enuno/unifi-mcp-server. Scaffold a new UniFi MCP tool with model, function, tests, and docs

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

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: An MCP server that leverages official UniFi API. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/source-command-unifi-mcp-add-tool”

Requirements

  • Python 3

Workflow steps

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

  1. Ask the user for tool details
  2. Create or update the Pydantic model in src/models/
  3. Create the tool function in src/tools/
  4. Register the tool in src/main.py
  5. Create comprehensive unit tests in tests/unit/
  6. Update API.md documentation
  7. Run validation

What it can do on your machine

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

    • black
    • pytest
    • python

    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

Source Command Unifi MCP Add Tool loads about 748 tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 313 words of instructions outside code blocks.

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

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 enuno/unifi-mcp-server at commit 7bd7449, republished under its Apache-2.0 licence (© enuno). 313 words, ~748 tokens.

Download SKILL.mdSave it as .claude/skills/source-command-unifi-mcp-add-tool/SKILL.md (or your agent's skills folder).
name
source-command-unifi-mcp-add-tool
description
Scaffold a new UniFi MCP tool with model, function, tests, and docs

source-command-unifi-mcp-add-tool

Use this skill when the user asks to run the migrated source command unifi-mcp-add-tool.

Command Template

Scaffold a complete new MCP tool for the UniFi MCP Server.

This command creates all necessary files and code for a new tool following the project's architecture and standards.

Steps to execute:

  1. Ask the user for tool details:

    • Tool name (e.g., "get_port_profile")
    • Tool category (e.g., "networks", "devices", "clients", "firewall")
    • Brief description of what the tool does
    • UniFi API endpoint it will use
    • Whether it's a read-only or mutating operation
  2. Create or update the Pydantic model in src/models/:

    • If the model file for the category doesn't exist, create it
    • Add request/response models based on UniFi API schema
    • Include proper type hints and field descriptions
    • Add validators if needed
  3. Create the tool function in src/tools/:

    • If the tool file for the category doesn't exist, create it
    • Implement async tool function with proper error handling
    • Add confirmation/dry-run support for mutating operations
    • Include comprehensive docstring with:
      • Description
      • Parameters
      • Returns
      • Raises
      • Example usage
  4. Register the tool in src/main.py:

    • Add import statement
    • Register tool with FastMCP
  5. Create comprehensive unit tests in tests/unit/:

    • Test file following naming convention: test_<category>_tools.py
    • Include tests for:
      • Success case with mocked API response
      • Error handling (authentication, network, API errors)
      • Validation of parameters
      • Confirmation/dry-run mode (if applicable)
    • Aim for 80%+ coverage
  6. Update API.md documentation:

    • Add tool to appropriate category section
    • Include description, parameters, returns, example
  7. Run validation:

    • Format code: black src/ tests/
    • Check tests: pytest tests/unit/test_<category>_tools.py -v
    • Verify registration: python -c "from src.main import mcp; print(mcp.list_tools())"

Report back with:

  • Summary of files created/modified
  • Tool registration confirmation
  • Test results
  • Next steps for integration testing
  • Reminder to update TESTING_PLAN.md if needed

Example workflow:

User: "I want to add a tool to get WLAN groups"
Assistant:
1. Creates src/models/wifi.py with WLANGroupResponse model
2. Creates src/tools/wifi.py with get_wlan_groups() function
3. Updates src/main.py to register the tool
4. Creates tests/unit/test_wifi_tools.py
5. Updates API.md with documentation
6. Runs tests and reports results

Safety checks:

  • Never expose sensitive credentials in code
  • Always use async/await for I/O operations
  • Include proper type hints for all parameters
  • Follow the principle of least privilege
  • Validate all user inputs

© enuno, Apache-2.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 .agents/skills/source-command-unifi-mcp-add-tool of enuno/unifi-mcp-server.

Open the folder on GitHubat commit 7bd7449

Compare with similar skills

Source Command Unifi MCP Add Tool 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.

Source Command Unifi MCP Add Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Source Command Unifi MCP Add Tool this skillenuno/unifi-mcp-server282—~748Automated safety check: PassApache-2.0
Agent QA Authoringvostride/agent-qa903—~569Automated safety check: PassCustom licence
Agent QA Result Triagevostride/agent-qa903—~394Automated safety check: PassCustom licence
Lightpandalightpanda-io/agent-skill101—~6kAutomated safety check: PassApache-2.0
Opik Comparecomet-ml/opik-mcp220—~2.6kAutomated safety check: NotesApache-2.0
Agent QA Debug Fixvostride/agent-qa903—~398Automated safety check: PassCustom licence

Similar skills

  • Agent QA Authoring

    vostride/agent-qa

    A skill your agent uses when creating, editing, validating, or running agent-qa tests, suites, or hooks.

    903 GitHub stars~569 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Agent QA Result Triage

    vostride/agent-qa

    A skill your agent uses when investigating failed agent-qa runs, inspecting artifacts, classifying failures, or comparing recent runs.

    903 GitHub stars~394 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Lightpanda

    lightpanda-io/agent-skill

    Lightpanda browser, drop-in replacement for Chrome-based browsing in any AI agent - faster and lighter for tasks without graphical rendering like data retrieval.

    101 GitHub stars~6k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Opik Compare

    comet-ml/opik-mcp

    Run a candidate against the baseline over an Opik test suite and read the numbers back — which cases broke, which got fixed, the per-metric deltas, worst rows, and whether the two runs are…

    220 GitHub stars~2.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Agent QA Debug Fix

    vostride/agent-qa

    Use after an agent-qa run has failed and you need to debug, patch, and verify the issue using MCP evidence, logs, artifacts, and local code changes instead of generated fix suggestions.

    903 GitHub stars~398 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Python Tests

    PrefectHQ/fastmcp

    Write regression tests for FastMCP changes using its pytest fixtures, in-memory clients, and protocol boundaries.

    28k GitHub stars~466 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from enuno/unifi-mcp-server

All 12 skills in this repo
  • Unifi

    enuno/unifi-mcp-server

    Manage UniFi network infrastructure via the UniFi MCP Server.

    282 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Unifi MCP Tool Builder

    enuno/unifi-mcp-server

    Specialized guide for adding new MCP tools to the UniFi MCP Server following project standards, UniFi API patterns, and test-driven development practices.

    282 GitHub stars~5.8k tokensUpdated today
    Auto-check passed
  • Prepare a new release with version bump, changelog, and quality checks

    282 GitHub stars~939 tokensUpdated today
    Auto-check passed
  • Auto-generate and update API.md documentation from tool docstrings

    282 GitHub stars~899 tokensUpdated today
    Auto-check passed

Questions about Source Command Unifi MCP Add Tool

What does Source Command Unifi MCP Add Tool do?

Scaffold a new UniFi MCP tool with model, function, tests, and docs. Source Command Unifi MCP Add Tool is an agent skill from enuno/unifi-mcp-server.

When should I use Source Command Unifi MCP Add Tool?

Source Command Unifi MCP Add Tool fits situations like: tasks that involve MCP servers.

How do I install Source Command Unifi MCP Add Tool in Claude Code?

Run `npx skills add enuno/unifi-mcp-server --skill source-command-unifi-mcp-add-tool -a claude-code`. Or copy the skill folder (.agents/skills/source-command-unifi-mcp-add-tool in enuno/unifi-mcp-server) into .claude/skills/source-command-unifi-mcp-add-tool in your project. Claude Code loads it when a task matches its description.

How do I install Source Command Unifi MCP Add Tool in Codex?

Run `npx skills add enuno/unifi-mcp-server --skill source-command-unifi-mcp-add-tool -a codex`. Or copy the skill folder (.agents/skills/source-command-unifi-mcp-add-tool in enuno/unifi-mcp-server) into .agents/skills/source-command-unifi-mcp-add-tool in your project. Codex loads it when a task matches its description.

Can I use Source Command Unifi MCP Add Tool 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 enuno/unifi-mcp-server --skill source-command-unifi-mcp-add-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/source-command-unifi-mcp-add-tool, .gemini/skills/source-command-unifi-mcp-add-tool, .github/skills/source-command-unifi-mcp-add-tool and .opencode/skills/source-command-unifi-mcp-add-tool in your project.

What does Source Command Unifi MCP Add Tool need to run?

Going by SKILL.md and its folder, Source Command Unifi MCP Add Tool needs the command-line tools its instructions call (black, pytest and python). Our summary lists: Python 3.

Does Source Command Unifi MCP Add Tool 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 Source Command Unifi MCP Add Tool 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 Source Command Unifi MCP Add Tool use?

Source Command Unifi MCP Add Tool is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Source Command Unifi MCP Add Tool use?

About 748 tokens (SKILL.md is roughly 3k 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 Source Command Unifi MCP Add Tool?

Skills that share tags, products or a category with Source Command Unifi MCP Add Tool: Agent QA Authoring (vostride/agent-qa, 903 stars), Agent QA Result Triage (vostride/agent-qa, 903 stars), Lightpanda (lightpanda-io/agent-skill, 101 stars) and Opik Compare (comet-ml/opik-mcp, 220 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Source Command Unifi MCP Add Tool?

enuno (a GitHub user) maintains it in enuno/unifi-mcp-server, which has 282 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

Source: enuno/unifi-mcp-server on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.