Agent skill

Update Ls Config

by swagger-api in swagger-api/apidom

Updates apidom-ls configuration for a namespace package by analyzing the namespace structure and creating completion, documentation, and lint configurations

No licenceAuto-check passedBackend & APIs

Install Update Ls Config

skills CLI
$ npx skills add swagger-api/apidom --skill update-ls-config -a claude-code

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

GitHub CLI
$ gh skill install swagger-api/apidom update-ls-config --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/swagger-api/apidom.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/update-ls-config .claude/skills/update-ls-config && 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
update-ls-config
GitHub stars
100
Token cost
~5.9k tokens
SKILL.md length
1,800 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
None found

At a glance

Updates apidom-ls configuration for a namespace package by analyzing the namespace structure and creating completion, documentation, and lint configurations

  • Works in 12 steps: Gather Information → Analyze Namespace Package → Determine Config Directory Structure → …
  • Tasks that involve OpenAPI specifications
  • SKILL.md covers Overview, When to Use, Prerequisites and Skill Instructions, plus 3 more sections
  • Calls npm; reaches github.com

What it does

Update Ls Config is an agent skill from swagger-api/apidom. Updates apidom-ls configuration for a namespace package by analyzing the namespace structure and creating completion, documentation, and lint configurations

Its SKILL.md is about 5.9k 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 Backend & APIs, covering OpenAPI specifications and Linting and formatting. It works with OpenAPI and JavaScript. The repository describes itself as: Semantic parser for API specifications.

When your agent uses it

  • Tasks that involve OpenAPI specifications
  • Tasks that involve Linting and formatting

Example prompts

  • “Use the update-ls-config skill to update apidom-ls configuration for a namespace package by analyzing the namespace structure and creating…”
  • “/update-ls-config”

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Gather Information
  2. Analyze Namespace Package
  3. Determine Config Directory Structure
  4. Generate Target Spec Definition
  5. Generate Configuration Files
  6. Update Element-Specific Configs
  7. Update Main Config Files
  8. Validation and Testing
  9. Document Changes
  10. New HTTP Methods or Operations
  11. Dynamic Collections
  12. Version-Specific Fields

What it can do on your machine

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

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    Also links to:

    • microsoft.github.io
    • code.visualstudio.com

    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

Update Ls Config loads about 5.9k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 1,800 words of instructions outside code blocks.

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

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,800 words (~5,880 tokens).

“Skill Name: update-ls-config Description: Updates apidom-ls configuration for a specific namespace package by analyzing the namespace structure and creating completion, documentation, and lint configurations.”

— opening of SKILL.md by swagger-api
name
update-ls-config
disable-model-invocation
false
user-invocable
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/update-ls-config of swagger-api/apidom.

Open the folder on GitHubat commit 8505e65

Compare with similar skills

Update Ls Config 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.

Update Ls Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Ls Config this skillswagger-api/apidom100—~5.9kAutomated safety check: PassNone
Assisted Service Dev Modeopenshift/assisted-service138—~1.3kAutomated safety check: PassApache-2.0
Counterfact Replcounterfact/api-simulator170—~3.2kAutomated safety check: PassMIT
Sap API Stylesecondsky/sap-skills462—~4.4kAutomated safety check: PassGPL-3.0
Counterfact Repo Basicscounterfact/api-simulator170—~868Automated safety check: PassMIT
API SpectralAgentSecOps/SecOpsAgentKit2201 repos~5.6kAutomated safety check: PassCustom licence

Similar skills

  • Assisted Service Dev Mode

    openshift/assisted-service

    Build and code-generate assisted-service using skipper with podman.

    138 GitHub stars~1.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Counterfact Repl

    counterfact/api-simulator

    Interact with Counterfact mock API server programmatically. An agent skill from counterfact/api-simulator.

    170 GitHub stars~3.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Sap API Style

    secondsky/sap-skills

    This skill provides comprehensive guidance for documenting SAP APIs following the SAP API Style Guide standards.

    462 GitHub stars~4.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Counterfact Repo Basics

    counterfact/api-simulator

    Provide Counterfact repository orientation, high-level architecture, and the canonical command reference for install/build/test/lint workflows.

    170 GitHub stars~868 tokensUpdated today
    Backend & APIsAuto-check passed
  • API Spectral

    AgentSecOps/SecOpsAgentKit

    API specification linting and security validation using Stoplight's Spectral with support for OpenAPI, AsyncAPI, and Arazzo specifications.

    220 GitHub starsUsed in 1 repo~5.6k tokens
    Backend & APIsAuto-check passed
  • Running CI Preflight

    PostHog/posthog

    Official

    Catch the deterministic CI failures reachable from your diff before pushing, with hogli ci:preflight.

    40k GitHub stars~1.5k tokensUpdated today
    Backend & APIsAuto-check passed

More from swagger-api/apidom

  • Add Namespace

    swagger-api/apidom

    Creates a new namespace package for a new API specification version in the ApiDOM monorepo

    100 GitHub stars~8.1k tokensUpdated 2 days ago
    Auto-check passed
  • Add Parser Adapter

    swagger-api/apidom

    Creates parser adapter packages for existing ApiDOM namespace packages and integrates them with apidom-reference

    100 GitHub stars~11k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Update Ls Config

What does Update Ls Config do?

Updates apidom-ls configuration for a namespace package by analyzing the namespace structure and creating completion, documentation, and lint configurations. Update Ls Config is an agent skill from swagger-api/apidom.

When should I use Update Ls Config?

Update Ls Config fits situations like: tasks that involve OpenAPI specifications; tasks that involve Linting and formatting.

How do I install Update Ls Config in Claude Code?

Run `npx skills add swagger-api/apidom --skill update-ls-config -a claude-code`. Or copy the skill folder (.claude/skills/update-ls-config in swagger-api/apidom) into .claude/skills/update-ls-config in your project. Claude Code loads it when a task matches its description.

How do I install Update Ls Config in Codex?

Run `npx skills add swagger-api/apidom --skill update-ls-config -a codex`. Or copy the skill folder (.claude/skills/update-ls-config in swagger-api/apidom) into .agents/skills/update-ls-config in your project. Codex loads it when a task matches its description.

Can I use Update Ls Config 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 swagger-api/apidom --skill update-ls-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-ls-config, .gemini/skills/update-ls-config, .github/skills/update-ls-config and .opencode/skills/update-ls-config in your project.

What does Update Ls Config need to run?

Going by SKILL.md and its folder, Update Ls Config needs the command-line tools its instructions call (npm).

Does Update Ls Config access the network?

SKILL.md names 3 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: microsoft.github.io and code.visualstudio.com. This is read from the text; nothing was executed.

Is Update Ls Config 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 Update Ls Config use?

No licence was found for Update Ls Config or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Update Ls Config use?

About 5.9k tokens (SKILL.md is roughly 24k 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 Update Ls Config?

Skills that share tags, products or a category with Update Ls Config: Assisted Service Dev Mode (openshift/assisted-service, 138 stars), Counterfact Repl (counterfact/api-simulator, 170 stars), Sap API Style (secondsky/sap-skills, 462 stars) and Counterfact Repo Basics (counterfact/api-simulator, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Ls Config?

swagger-api (a GitHub organization) maintains it in swagger-api/apidom, which has 100 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 5, 2026.

Source: swagger-api/apidom on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.