From 7ad43d1d3196f17a89530f51b7c1bae4c89603fb Mon Sep 17 00:00:00 2001 From: Yannik Tausch Date: Wed, 12 Aug 2026 14:34:58 +0200 Subject: [PATCH 1/3] docs: Document packaged custom updater skill --- docs/contents/plugins/one-off-updaters.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/contents/plugins/one-off-updaters.md b/docs/contents/plugins/one-off-updaters.md index c7645f6..f095c34 100644 --- a/docs/contents/plugins/one-off-updaters.md +++ b/docs/contents/plugins/one-off-updaters.md @@ -17,7 +17,18 @@ Result processing belongs in an [installable aggregator](installable-plugins.md# ## Let a coding agent write it The repository ships a [`create-custom-updater` skill](https://github.com/quantco/quant-ranger/blob/main/skills/create-custom-updater/SKILL.md) that teaches coding agents to write, debug, and run one-off updaters. -Install it with the [`skills` CLI](https://github.com/vercel-labs/skills): +The conda-forge `quant-ranger` package depends on the matching skill package, so the skill is already present in your Pixi environment. +Install [pixi-skills](https://pixi.prefix.dev/latest/integration/extensions/pixi_skills/) once and configure the skill for your coding agent: + +```bash +pixi global install pixi-skills +pixi skills manage +``` + +The interactive prompt lets you select `create-custom-updater`, your coding agent, and whether to configure it for the current project or globally. +No separate installation of the skill is required. + +You can also install the skill directly from the repository with the [`skills` CLI](https://github.com/vercel-labs/skills): ```bash npx skills add quantco/quant-ranger --skill create-custom-updater From dfe2bfc8b361a9eaeb704508e8beac030ec55dd8 Mon Sep 17 00:00:00 2001 From: Yannik Tausch Date: Wed, 12 Aug 2026 14:38:02 +0200 Subject: [PATCH 2/3] docs: Clarify custom skill setup alternatives --- docs/contents/plugins/one-off-updaters.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/contents/plugins/one-off-updaters.md b/docs/contents/plugins/one-off-updaters.md index f095c34..55c12f9 100644 --- a/docs/contents/plugins/one-off-updaters.md +++ b/docs/contents/plugins/one-off-updaters.md @@ -18,17 +18,16 @@ Result processing belongs in an [installable aggregator](installable-plugins.md# The repository ships a [`create-custom-updater` skill](https://github.com/quantco/quant-ranger/blob/main/skills/create-custom-updater/SKILL.md) that teaches coding agents to write, debug, and run one-off updaters. The conda-forge `quant-ranger` package depends on the matching skill package, so the skill is already present in your Pixi environment. -Install [pixi-skills](https://pixi.prefix.dev/latest/integration/extensions/pixi_skills/) once and configure the skill for your coding agent: +Run [pixi-skills](https://github.com/pavelzw/pixi-skills) through `pixi exec` to configure the skill for your coding agent: ```bash -pixi global install pixi-skills -pixi skills manage +pixi exec pixi-skills manage ``` The interactive prompt lets you select `create-custom-updater`, your coding agent, and whether to configure it for the current project or globally. No separate installation of the skill is required. -You can also install the skill directly from the repository with the [`skills` CLI](https://github.com/vercel-labs/skills): +Alternatively, install the skill directly from the repository with the [`skills` CLI](https://github.com/vercel-labs/skills): ```bash npx skills add quantco/quant-ranger --skill create-custom-updater From a848a86da77f4e1da97729dba907345ffe784efe Mon Sep 17 00:00:00 2001 From: Yannik Tausch Date: Wed, 12 Aug 2026 14:40:55 +0200 Subject: [PATCH 3/3] docs: Name pixi-skills package format --- docs/contents/plugins/one-off-updaters.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/contents/plugins/one-off-updaters.md b/docs/contents/plugins/one-off-updaters.md index 55c12f9..dd3be76 100644 --- a/docs/contents/plugins/one-off-updaters.md +++ b/docs/contents/plugins/one-off-updaters.md @@ -17,8 +17,8 @@ Result processing belongs in an [installable aggregator](installable-plugins.md# ## Let a coding agent write it The repository ships a [`create-custom-updater` skill](https://github.com/quantco/quant-ranger/blob/main/skills/create-custom-updater/SKILL.md) that teaches coding agents to write, debug, and run one-off updaters. -The conda-forge `quant-ranger` package depends on the matching skill package, so the skill is already present in your Pixi environment. -Run [pixi-skills](https://github.com/pavelzw/pixi-skills) through `pixi exec` to configure the skill for your coding agent: +The conda-forge `quant-ranger` package depends on a matching [pixi-skills](https://github.com/pavelzw/pixi-skills) skills package, so the skill is already present in your Pixi environment. +Run pixi-skills through `pixi exec` to configure the skill for your coding agent: ```bash pixi exec pixi-skills manage