Agent skill

Configuration

by live-codes in live-codes/livecodes

Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings.

MITAuto-check passed

Install Configuration

skills CLI
$ npx skills add live-codes/livecodes --skill configuration -a claude-code

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

GitHub CLI
$ gh skill install live-codes/livecodes configuration --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/live-codes/livecodes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/livecodes/configuration .claude/skills/configuration && 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
configuration
GitHub stars
1.5k
Token cost
~4.5k tokens
SKILL.md length
726 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings.

  • SKILL.md covers Setup, Core Patterns, Common Mistakes and Config Reference, plus 2 more sections
  • Reaches livecodes.io and cdn.jsdelivr.net

What it does

Configuration is an agent skill from live-codes/livecodes. Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings. Load this skill when setting up project content, configuring CSS processors, or customizing display.

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

The repository describes itself as: A Code Playground That Just Works! The licence is MIT.

Example prompts

  • “/configuration”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).

    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:

    • livecodes.io
    • cdn.jsdelivr.net

    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

Configuration loads about 4.5k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 726 words of instructions outside code blocks.

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

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 live-codes/livecodes at commit 5754e89, republished under its MIT licence (© live-codes). 726 words, ~4,521 tokens.

Download SKILL.mdSave it as .claude/skills/configuration/SKILL.md (or your agent's skills folder).
name
configuration
description
Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings. Load this skill when setting up project content, configuring CSS processors, or customizing display.
metadata.type
core
metadata.library
livecodes
metadata.library_version
0.13.0
sources
live-codes/livecodes:docs/docs/configuration/configuration-object.mdx, live-codes/livecodes:docs/docs/configuration/query-params.mdx…

LiveCodes — Configure Playground

LiveCodes uses configuration objects to define project content and behavior. Config can be passed to createPlayground or set via URL parameters.

Setup

javascript
import { createPlayground } from 'livecodes';

// Full config object
createPlayground('#container', {
  config: {
    title: 'My Project',
    markup: { language: 'html', content: '<h1>Hello</h1>' },
    style: { language: 'css', content: 'h1 { color: blue; }' },
    script: { language: 'javascript', content: 'console.log("hi")' },
    activeEditor: 'script',
  },
});

// Query params (simpler syntax)
createPlayground('#container', {
  params: {
    html: '<h1>Hello</h1>',
    css: 'h1 { color: blue; }',
    js: 'console.log("hi")',
    console: 'open',
  },
});

Core Patterns

Configure each editor
javascript
const config = {
  markup: {
    language: 'markdown',
    content: '# Title\n\nParagraph',
    contentUrl: 'https://example.com/content.md', // Alternative to content
  },
  style: {
    language: 'scss',
    content: '$color: blue; h1 { color: $color; }',
  },
  script: {
    language: 'typescript',
    content: 'const x: number = 1;',
    hiddenContent: 'export function helper() {}', // Hidden but evaluated
  },
};
Enable CSS processors
javascript
const config = {
  style: { language: 'css', content: '...' },
  processors: ['tailwindcss', 'autoprefixer'], // Processors run in order
};
Add external resources
javascript
const config = {
  stylesheets: ['https://cdn.jsdelivr.net/npm/tailwindcss@3/dist/tailwind.min.css'],
  scripts: ['https://cdn.jsdelivr.net/npm/lodash@4/lodash.min.js'],
};
Configure tests
javascript
const config = {
  tests: {
    language: 'typescript',
    content: `
      import { sum } from './script';
      test('sums numbers', () => {
        expect(sum(1, 2)).toBe(3);
      });
    `,
  },
};
Set display mode
javascript
const config = {
  mode: 'simple', // 'full' | 'focus' | 'simple' | 'lite' | 'editor' | 'codeblock' | 'result'
  view: 'result', // 'split' | 'editor' | 'result'
  readonly: true, // Read-only mode
};
Configure editor settings
javascript
const config = {
  editor: 'monaco', // 'monaco' | 'codemirror' | 'codejar' | 'auto'
  theme: 'dark', // 'light' | 'dark'
  editorTheme: 'vs-dark', // See themes in docs
  fontFamily: 'Fira Code',
  fontSize: 14,
  useTabs: false,
  tabSize: 2,
  lineNumbers: true,
  wordWrap: false,
  emmet: true,
  editorMode: 'vim', // 'vim' | 'emacs' | undefined
};
Add custom imports
javascript
const config = {
  imports: {
    'my-lib': 'https://my-cdn.com/lib.js',
    'my-lib/submodule': 'https://my-cdn.com/sub.js',
  },
};
Use URL query parameters

URL: https://livecodes.io/?js=console.log("Hello")&console=open&theme=light

javascript
// Equivalent in createPlayground
createPlayground('#container', {
  params: {
    js: 'console.log("Hello")',
    console: 'open',
    theme: 'light',
  },
});
Hidden content for embedded playgrounds
javascript
const config = {
  script: {
    language: 'javascript',
    content: 'export function myFunc() { return 42; }',
    hiddenContent: '// Hidden helper\nfunction helper() { return 1; }',
  },
  tests: {
    language: 'javascript',
    content: "import { myFunc } from './script';\ntest('works', () => expect(myFunc()).toBe(42))",
  },
};

Common Mistakes

HIGH Confusing Config with EmbedOptions

Wrong:

javascript
createPlayground('#container', {
  config: {
    appUrl: 'https://my-server.com', // Wrong: appUrl belongs in EmbedOptions
    template: 'react', // Wrong: template belongs in EmbedOptions
  },
});

Correct:

javascript
createPlayground('#container', {
  // EmbedOptions (SDK-level settings)
  appUrl: 'https://my-server.com',
  template: 'react',
  loading: 'lazy',
  headless: false,

  // Config (Project content)
  config: {
    title: 'My Project',
    markup: { language: 'html', content: '<h1>Hello</h1>' },
    style: { language: 'css', content: '...' },
    script: { language: 'javascript', content: '...' },
  },
});

EmbedOptions controls how the playground is embedded (appUrl, template, loading, headless). Config controls the project content (languages, code, processors).

Source: docs/docs/sdk/js-ts.mdx — EmbedOptions section

MEDIUM Params overriding config unexpectedly

Wrong:

javascript
createPlayground('#container', {
  config: {
    markup: { language: 'html', content: '<h1>A</h1>' },
  },
  params: {
    html: '<h1>B</h1>', // This overrides config.markup!
  },
});

Correct:

javascript
// Use one source or understand precedence:
// params > config > import > template

createPlayground('#container', {
  params: {
    html: '<h1>B</h1>',
  },
  // No config needed for simple cases
});

// Or use config only
createPlayground('#container', {
  config: {
    markup: { language: 'html', content: '<h1>A</h1>' },
  },
});

When both config and params are provided, params takes precedence. Use one or the other for clarity.

Source: docs/docs/sdk/js-ts.mdx — Multiple Sources section

MEDIUM Using incorrect language name

Wrong:

javascript
const config = {
  script: { language: 'react.js', content: '...' }, // Invalid
};

Correct:

javascript
// Use language name, extension, or alias
const config = {
  script: { language: 'react', content: '...' }, // Language name
  // or
  script: { language: 'jsx', content: '...' }, // Extension
  // or
  script: { language: 'react-jsx', content: '...' }, // Alias
};

Language names must match supported values. See languages reference for all options.

Source: src/sdk/models.ts — Language type

Config Reference

Project Content
PropertyTypeDefaultDescription
titlestring"Untitled Project"Project title, used as result page title
descriptionstring""Project description, used in search
headstring"<meta charset...>"Custom content for <head> element
htmlAttrsstring | object'lang="en" class=""'Attributes for <html> element
tagsstring[][]Project tags for filtering/search
activeEditor"markup" | "style" | "script""markup"Which editor is visible
languagesLanguage[]all languagesEnabled languages in editor dropdown
Editor Content (markup, style, script, tests)

Each editor config object supports:

PropertyTypeDefaultDescription
languageLanguage(varies by editor)Language name, extension, or alias
contentstring""Initial code content
contentUrlstring—URL to load content from
hiddenContentstring—Hidden code (evaluated but not visible)
hiddenContentUrlstring—URL to load hidden content
foldedLinesArray<{from, to}>—Lines to fold on load
titlestring—Override editor title
hideTitleboolean—Hide editor title
ordernumber0Editor order in UI
selectorstring—CSS selector for DOM import
position{lineNumber, column?}—Initial cursor position
External Resources
PropertyTypeDefaultDescription
stylesheetsstring[][]URLs for external CSS
scriptsstring[][]URLs for external JS
cssPreset"" | "normalize.css" | "reset-css"""CSS preset to apply
processorsProcessor[][]CSS processors (tailwindcss, autoprefixer, etc.)
Module Resolution
PropertyTypeDefaultDescription
importsRecord<string, string>{}Custom import map for module resolution
typesRecord<string, string | object>{}Custom TypeScript type declarations
App Settings
PropertyTypeDefaultDescription
readonlybooleanfalseRead-only mode
allowLangChangebooleantrueAllow changing editor language
view"split" | "editor" | "result""split"Default view
mode"full" | "focus" | "simple" | "lite" | "editor" | "codeblock" | "result""full"Display mode
toolsobject{enabled: "all", active: "", status: ""}Tools pane config
zoom1 | 0.5 | 0.251Result page zoom level
Show full SKILL.md (317 more words)Show less
User Settings
PropertyTypeDefaultDescription
autoupdatebooleantrueAuto-run result on code change
autosavebooleanfalseAuto-save on code change
autotestbooleanfalseAuto-run tests on code change
delaynumber1500Delay before autoupdate/autosave (ms)
formatOnsavebooleanfalseFormat code on save
layout"horizontal" | "vertical" | "responsive""responsive"Editor layout
theme"light" | "dark""dark"App theme
themeColorstring"hsl(214, 40%, 50%)"App theme color
editorThemestring | string[]—Editor themes (see docs)
appLanguagestring—UI language code (e.g., "ar", "zh-CN")
recoverUnsavedbooleantrueEnable recovery of unsaved project
welcomebooleantrueShow welcome screen
showSpacingbooleanfalseShow element spacing in result
Editor Settings
PropertyTypeDefaultDescription
editor"monaco" | "codemirror" | "codejar" | "auto"—Code editor to use
fontFamilystring—Editor font family
fontSizenumber14 (full) / 12 (embed)Editor font size
useTabsbooleanfalseUse tabs instead of spaces
tabSizenumber2Spaces per indent level
lineNumbersboolean | "relative"trueShow line numbers
wordWrapbooleanfalseEnable word wrap
closeBracketsbooleantrueAuto-close brackets/quotes
foldRegionsbooleanfalseFold #region blocks on load
minimapbooleanfalseShow minimap (Monaco)
emmetbooleantrueEnable Emmet
editorMode"vim" | "emacs"—Editor key bindings
semicolonsbooleantrueUse semicolons in formatting
singleQuotebooleantrueUse single quotes in formatting
trailingCommabooleantrueUse trailing commas in formatting

EmbedOptions Reference

PropertyTypeDefaultDescription
appUrlstring"https://livecodes.io/"URL to self-hosted LiveCodes
configConfig | string{}Project config or URL to config JSON
templatestring—Starter template name
importstring—URL to import code from
paramsobject{}URL query parameters
loading"eager" | "lazy" | "click""lazy"When to load playground
headlessbooleanfalseRun without UI

Query Parameters

Many config options can be set via URL parameters:

https://livecodes.io/?template=react&theme=light&console=open
ParamConfig Equivalent
templateEmbedOptions.template
xEmbedOptions.import
filesFiles to import (comma-separated)
rawImport URL as raw language
activeactiveEditor
modemode
themetheme
consoletools.status
no-defaultsSkip default template

Boolean params: ?lite, ?autoupdate=false Array params: ?processors=tailwindcss,autoprefixer Custom settings: ?customSettings.template.prerender=false

© live-codes, MIT. 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/livecodes/configuration of live-codes/livecodes.

Open the folder on GitHubat commit 5754e89

Compare with similar skills

Configuration 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.

Configuration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Configuration this skilllive-codes/livecodes1.5k—~4.5kAutomated safety check: PassMIT
Parametersthedaviddias/Front-End-Checklist74k—~638Automated safety check: PassMIT
PlaygroundArize-ai/phoenix12k—~3.9kAutomated safety check: PassCustom licence
Vuetify Playgroundvuetifyjs/vuetify41k—~730Automated safety check: PassCustom licence
Object Storagesickn33/agentic-awesome-skills47k2 repos~2.6kAutomated safety check: PassMIT
Object Altthedaviddias/Front-End-Checklist74k—~429Automated safety check: PassMIT

Similar skills

  • Parameters

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing URL structure or configuring search engine handling of filtered, sorted, or tracked URLs.

    74k GitHub stars~638 tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Playground

    Arize-ai/phoenix

    Author, edit, or iterate on prompts in the Phoenix prompt playground, including running experiments over a dataset.

    12k GitHub stars~3.9k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Vuetify Playground

    vuetifyjs/vuetify

    Maintains the Vuetify repo's local Playground.vue so contributors get a realistic reproduction and a short demo they can paste into a pull request description.

    41k GitHub stars~730 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Object Storage

    sickn33/agentic-awesome-skills

    Configure object storage with S3, GCS, and MinIO. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~2.6k tokens
    Backend & APIsAuto-check passed
  • Object Alt

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Provide alternative text for objects.

    74k GitHub stars~429 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Matlab Configure Scope Object

    matlab/matlab-agentic-toolkit

    Prevents crashes due to problematic scope-related API misuse caused by agent escalation into internal scope framework objects.

    1.1k GitHub stars~2k tokensUpdated 7 days ago
    Auto-check passed

More from live-codes/livecodes

All 15 skills in this repo
  • Language Support

    live-codes/livecodes

    Work with 90+ supported languages, compilers, CSS processors, and WASM-compiled languages for markup, style, and script editors.

    1.5k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Display Modes

    live-codes/livecodes

    Configure how the playground is displayed: full, focus, simple, lite, editor, codeblock, and result modes.

    1.5k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Framework Wrappers

    live-codes/livecodes

    Use SDK with React, Vue, Svelte, Solid, Preact, and Web Components.

    1.5k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Getting Started

    live-codes/livecodes

    Quick start for standalone app at livecodes.io, embedding playgrounds with CDN or npm, and self-hosting basics.

    1.5k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Gh Action

    live-codes/livecodes

    Use the "Preview in LiveCodes" GitHub Action to generate preview playground links for pull request code changes.

    1.5k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Headless Mode

    live-codes/livecodes

    Run playground without visible UI using SDK methods directly.

    1.5k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Configuration

What does Configuration do?

Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings. Configuration is an agent skill from live-codes/livecodes. Configure playground behavior through Config object, query parameters, EmbedOptions, editor settings, processors, external resources, and custom settings.

How do I install Configuration in Claude Code?

Run `npx skills add live-codes/livecodes --skill configuration -a claude-code`. Or copy the skill folder (.agents/skills/livecodes/configuration in live-codes/livecodes) into .claude/skills/configuration in your project. Claude Code loads it when a task matches its description.

How do I install Configuration in Codex?

Run `npx skills add live-codes/livecodes --skill configuration -a codex`. Or copy the skill folder (.agents/skills/livecodes/configuration in live-codes/livecodes) into .agents/skills/configuration in your project. Codex loads it when a task matches its description.

Can I use Configuration 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 live-codes/livecodes --skill configuration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/configuration, .gemini/skills/configuration, .github/skills/configuration and .opencode/skills/configuration in your project.

What does Configuration need to run?

SKILL.md names no scripts, command-line tools or credentials: Configuration is instructions for the agent only.

Does Configuration access the network?

SKILL.md names 2 domains. In commands or code: livecodes.io and cdn.jsdelivr.net; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Configuration 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 Configuration use?

Configuration is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Configuration use?

About 4.5k tokens (SKILL.md is roughly 18k 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 Configuration?

Skills that share tags, products or a category with Configuration: Parameters (thedaviddias/Front-End-Checklist, 74k stars), Playground (Arize-ai/phoenix, 12k stars), Vuetify Playground (vuetifyjs/vuetify, 41k stars) and Object Storage (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Configuration?

live-codes (a GitHub organization) maintains it in live-codes/livecodes, which has 1,512 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 6, 2026.

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