skills.rest
posit-dev
posit-devOFFICIAL
Explore all skills by this author →
GitHub

positron-settings

Inspect live Positron configuration state and settings registry via built-in commands.

4.2k|179|Updated May 24, 2022
Search Tags:#settings#IDE#positron#Configuration#Troubleshooting#inspect#preview features
One-click install
npx skills add https://github.com/posit-dev/positron --skill positron-settings
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: positron-settings
Source: https://github.com/posit-dev/positron/tree/main/extensions/positron-skills/templates/positron-settings
Command: npx skills add https://github.com/posit-dev/positron --skill positron-settings

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Answers questions about what a user has actually configured in their running Positron install, which documentation pages, release notes, and raw settings.json file reads cannot reliably answer, since those sources cannot know this specific build's live state.

Core Features & Use Cases

  • Configured Settings Inspection: Uses the positronSettings.getConfiguredSettings command to report which settings the user has explicitly set, their effective values, provenance, and reasons a setting is being ignored (such as policy overrides).
  • Settings Registry Search: Uses the positronSettings.findSettings command to search every setting the build registers, including defaults, allowed values, current values, and preview or experimental feature tags.
  • Gating Conflict Detection: Carries known settings-that-gate-other-settings relationships (such as ai.enabled gating all AI features) so conflicts are surfaced even when the user did not ask.
  • Use Case: A user asks "why isn't my AI assistant setting working?" The skill queries the live configuration, finds the setting is set but gated by a disabled parent switch, and reports the exact conflict instead of guessing.

Quick Start

Ask the assistant which settings you currently have configured in Positron and whether any of them are being ignored or overridden.

Frequently Asked Questions about positron-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check which settings I have configured in Positron?▼

Use the positronSettings.getConfiguredSettings command, which reports only the settings you have explicitly set, along with their effective values and sources. An optional filter argument narrows the result to a specific area such as AI settings.

How do I find which Positron features are in preview or experimental?▼

Call positronSettings.findSettings with the tag argument set to "preview" and again with "experimental". This queries the running build's own settings registry, which is accurate for your install, unlike release notes or documentation pages.

Why is a setting I set in Positron not taking effect?▼

The getConfiguredSettings payload marks such entries with an ignored field explaining why, such as overridden-by-policy when an administrator enforces the value. A setting can also be in force but do nothing because a gating switch like ai.enabled above it is turned off.

Can I read my settings.json file directly instead of querying Positron?▼

Reading settings.json paths is unreliable because the user-data location differs by deployment, and on remote or Posit Workbench setups the usual path can point to a different, often empty store. The skill's commands query live state and are correct everywhere.

What does registered: false mean for a Positron setting?▼

It means this Positron's configuration registry does not know the key, which could indicate a typo, a setting from an extension not installed in this window, or a setting an installed extension reads without declaring. It does not mean the setting is inert or safe to delete.

Related Skills

Explore More Software Engineering Skills→
robomotioniorobomotionio
2

homeassistant

Control Home Assistant devices and services via the Robomotion CLI.

Official
Intermediate
TheFVGTheFVG

update-cursor-settings

Modify VSCode user settings by editing the settings.json file.

Official
Intermediate
TrebuchetDynamicsTrebuchetDynamics
5

chrome-extensions

Diagnose Manifest V3 Chrome extension build and runtime configuration issues.

Official
Advanced
teaglebuiltteaglebuilt

update-cursor-settings

Modify Cursor/VSCode settings.json editor preferences while preserving existing settings.

Community
Intermediate