Skip to content

Configure the bare skills MCP on ug skills and quiet download registration - #729

Open
xsh310 wants to merge 8 commits into
mainfrom
skills-bare-configure-mcp
Open

xsh310 wants to merge 8 commits into
mainfrom
skills-bare-configure-mcp

Conversation

@xsh310

@xsh310 xsh310 commented Sep 18, 2026

Copy link
Copy Markdown
Collaborator

What changed and why

ug configure skills is being deprecated, so this adds a simple place to register the bare skills MCP connection: a bare ug skills. It also tunes what gets printed when the skills MCP is configured, so a successful registration never buries download failures.

  • Bare ug skills registers the schema-less skills MCP connection (utility tools only) for the configured agents, keeps any client's existing --mcp scope, and then prints the group help it always showed. On the first run it also prints a short note on how to create a skill. When a connection already exists it re-registers (still printing the connection summary) but omits that create-skill note.
  • Download paths (ug skills add without --mcp or --skill, and the interactive picker) no longer print the "Skills MCP registered" summary, which had been burying the per-skill download failures the download step already reports. register_schemaless_skills_connection gained a print_summary flag (default on) that these paths pass as False.
  • --mcp stays exactly as it was.

How do you know it works?

  • New unit tests cover: bare ug skills first run (configures, shows help, prints the create-skill note); an already-configured run (re-registers, omits the note); a subcommand skipping the entrypoint's configuration; the three download paths suppressing the summary; and configure_bare_skills_mcp_command reporting first run versus existing.
  • uv run ruff check is clean and uv run pytest passes. The one failing test is a pre-existing live-gateway e2e case unrelated to this change.

Note on the stack

This sits on top of #723 (its base is that PR's skills-list-command branch, so the diff is just this one commit). GitHub does not allow a fork PR to join a gh stack, so the two carry no stack badge; once #723 merges, retarget this to main.

Screenshot 2026-09-17 at 8 49 56 PM

This pull request and its description were written by Isaac.

@xsh310 xsh310 changed the title skills bare configure mcp Configure the bare skills MCP on ug skills and quiet download registration Sep 18, 2026
Comment thread src/ucode/cli.py Outdated
@xsh310
xsh310 marked this pull request as ready for review September 18, 2026 04:05
@xsh310
xsh310 changed the base branch from skills-list-command to main September 18, 2026 04:27
@xsh310
xsh310 added this pull request to stack #733 September 18, 2026 04:27
@xsh310
xsh310 force-pushed the skills-bare-configure-mcp branch 2 times, most recently from 58baa69 to fdd55b2 Compare September 18, 2026 05:18
xsh310 and others added 8 commits September 18, 2026 08:31
…tration

Bare `ug skills` now registers the schema-less skills MCP connection for the
configured agents (replacing `ug configure skills` with no arguments), keeping
any existing --mcp scope, and then prints the group help. On the first run it
adds a short note on how to create a skill. Skill downloads no longer print the
connection summary, so a successful registration can't bury the per-skill
download failures the download step already reported; `--mcp` is unchanged.

Co-authored-by: Isaac <no-reply@databricks.com>
Co-authored-by: Isaac <no-reply@databricks.com>
Co-authored-by: Isaac <no-reply@databricks.com>
A repeat `ug skills` still re-registers the connection but stays quiet, so the
summary shows once at setup rather than on every invocation.

Co-authored-by: Isaac <no-reply@databricks.com>
Add a `quiet` flag to setup_mcp_clients that drops the section header and the
"Configuring for" line (keeping missing-client warnings), and pass it on repeat
runs so a re-registration prints nothing at all.

Co-authored-by: Isaac <no-reply@databricks.com>
Show the group help first, then register and print the connection summary and the
create-skill note, so the actionable setup output lands at the bottom.

Co-authored-by: Isaac <no-reply@databricks.com>
The download paths pass `quiet=True` to setup_mcp_clients so a download prints
only its own progress and results (and any failures), never the skills MCP
setup header or connection summary.

Co-authored-by: Isaac <no-reply@databricks.com>
The lambda wrapping added in the prior commit tripped `ruff format --check`
(enforced by tests/test_lint.py); reformat to satisfy it. No behavior change.

Co-authored-by: Isaac <no-reply@databricks.com>
@xsh310
xsh310 force-pushed the skills-bare-configure-mcp branch from fdd55b2 to 7399345 Compare September 18, 2026 15:31
Comment thread README.md
agent skill directories.

```bash
# Register the skills MCP connection (utility tools only) for your agents.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need to mention this in the docs? Basically its quite everywhere, why mention it in the docs then?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also can ug skills display the help commands for skills?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants