Agent skill

Add Feature Flag

by cadence-workflow in cadence-workflow/cadence-web

Add a new boolean feature flag (dynamic config key) to cadence-web.

Apache-2.0Auto-check: notesBackend & APIs

Install Add Feature Flag

skills CLI
$ npx skills add cadence-workflow/cadence-web --skill add-feature-flag -a claude-code

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

GitHub CLI
$ gh skill install cadence-workflow/cadence-web add-feature-flag --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/cadence-workflow/cadence-web.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/add-feature-flag .claude/skills/add-feature-flag && 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
add-feature-flag
GitHub stars
436
Token cost
~1.1k tokens
SKILL.md length
302 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Add a new boolean feature flag (dynamic config key) to cadence-web.

  • Works in 5 steps: Resolver —… → Register —… → Zod schema —… → …
  • Set up a feature flag
  • SKILL.md covers Naming, Files to touch, Consuming the flag and When the feature ships, plus 1 more section
  • Calls npm and curl

What it does

Add Feature Flag is an agent skill from cadence-workflow/cadence-web. Add a new boolean feature flag (dynamic config key) to cadence-web. Use when asked to add, create, or set up a feature flag, config flag, or ENABLED toggle.

Its SKILL.md is about 1.1k 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 GraphQL. It works with webpack. The repository describes itself as: Web UI for visualizing workflows on Cadence. The licence is Apache-2.0.

When your agent uses it

  • Set up a feature flag
  • Tasks that involve GraphQL

Example prompts

  • “/add-feature-flag”

Workflow steps

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

  1. Resolver — src/config/dynamic/resolvers/.ts
  2. Register — src/config/dynamic/dynamic.config.ts
  3. Zod schema — src/config/dynamic/resolvers/schemas/resolver-schemas.ts
  4. Test fixture — src/utils/config/fixtures/resolved-config-values.ts
  5. Resolver test (only if the resolver has logic)

What it can do on your machine

Read from SKILL.md and the folder at commit 2586761. 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
    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use npm and curl, which can reach the network depending on how they are called.

    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

Add Feature Flag loads about 1.1k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 302 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:117
    AME>=true` under `### Feature flags` in `.env`

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 cadence-workflow/cadence-web at commit 2586761, republished under its Apache-2.0 licence (© cadence-workflow). 302 words, ~1,084 tokens.

Download SKILL.mdSave it as .claude/skills/add-feature-flag/SKILL.md (or your agent's skills folder).
name
add-feature-flag
description
Add a new boolean feature flag (dynamic config key) to cadence-web. Use when asked to add, create, or set up a feature flag, config flag, or `*_ENABLED` toggle.

Add a feature flag

Feature flags are dynamic config entries whose resolver returns boolean. Completeness is enforced by TypeScript — the fixture and the Zod schema map are typed against dynamicConfigs, so a missing entry fails npm run typecheck.

Reference example: WORKFLOW_DIAGNOSTICS_ENABLED (added in the same 4 files below).

Naming

  • Key: UPPER_SNAKE_CASE, ending in _ENABLED — e.g. WORKFLOW_DIAGNOSTICS_ENABLED
  • Env var: CADENCE_ + key — e.g. CADENCE_WORKFLOW_DIAGNOSTICS_ENABLED
  • Resolver file: kebab-case of the key — e.g. workflow-diagnostics-enabled.ts
  • Resolver function: camelCase of the key — e.g. workflowDiagnosticsEnabled

Files to touch

Add the new entry directly after a related existing flag in each file (not alphabetically).

1. Resolver — src/config/dynamic/resolvers/<flag-name>.ts
ts
/**
 * Returns whether <feature> is enabled.
 *
 * To enable, set the CADENCE_<FLAG_NAME> env variable to `true`.
 * For further customization, override the implementation of this resolver.
 *
 * @returns {Promise<boolean>} Whether <feature> is enabled.
 */
export default async function <flagName>(): Promise<boolean> {
  return process.env.CADENCE_<FLAG_NAME> === 'true';
}
  • Default export, async, returns Promise<boolean>.
  • Off by default; forks override the resolver.
  • If the flag depends on another flag, import and call that resolver rather than re-reading its env var (see workflow-diagnostics-in-history-enabled.ts). Check the cheap env var first.
  • If the flag needs args (e.g. { cluster, domain }), add <flag-name>.types.ts with a <FlagName>ResolverParams type (see cron-list-enabled.types.ts).
2. Register — src/config/dynamic/dynamic.config.ts

Three edits:

ts
// import (alphabetical by file path)
import <flagName> from './resolvers/<flag-name>';

// type block
<FLAG_NAME>: ConfigAsyncResolverDefinition<undefined, boolean, 'request', true>;

// runtime block
<FLAG_NAME>: {
  resolver: <flagName>,
  evaluateOn: 'request',
  isPublic: true,
},

Replace undefined with the args type if the resolver takes args. isPublic: true is what exposes the key to the client via /api/config.

3. Zod schema — src/config/dynamic/resolvers/schemas/resolver-schemas.ts
ts
<FLAG_NAME>: {
  args: z.undefined(), // or z.object({ cluster: z.string(), domain: z.string() })
  returnType: z.boolean(),
},
4. Test fixture — src/utils/config/__fixtures__/resolved-config-values.ts
ts
<FLAG_NAME>: false,

The getConfigValue auto-mock reads from this, so server-side tests see the new key automatically.

5. Resolver test (only if the resolver has logic)

Skip for a plain env-var check. If the resolver combines conditions, calls another resolver, or takes args, add src/config/dynamic/resolvers/__tests__/<flag-name>.node.ts. Mirror batch-actions-ui-enabled.node.ts: jest.mock the imported resolvers, save/restore the env var in beforeEach/afterEach.

Consuming the flag

Client:

ts
const { data: isEnabled } = useSuspenseConfigValue('<FLAG_NAME>');
// or non-suspense: useConfigValue('<FLAG_NAME>', args?)

Server (route handlers): await getConfigValue('<FLAG_NAME>').

Client tests mock the endpoint:

ts
render(<Component />, {
  endpointsMocks: [
    {
      path: '/api/config',
      httpMethod: 'GET',
      mockOnce: false,
      httpResolver: async () => HttpResponse.json(true),
    },
  ],
});

When the feature ships

Once the UI lands:

  • Add a row to the Feature flags table in README.md
  • Add a commented # CADENCE_<FLAG_NAME>=true under ### Feature flags in .env

Verify

bash
npm run typecheck                                  # proves fixture + schema are complete
npm run test:unit:node <flag-name>.node.ts         # if you added a resolver test
npm run test:unit:node -- src/route-handlers/get-config src/utils/config src/config/dynamic
npm run lint

Optional live check: npm run dev, then curl 'http://localhost:8088/api/config?configKey=<FLAG_NAME>' → false; rerun with CADENCE_<FLAG_NAME>=true npm run dev → true.

© cadence-workflow, Apache-2.0. 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/add-feature-flag of cadence-workflow/cadence-web.

Open the folder on GitHubat commit 2586761

Compare with similar skills

Add Feature Flag 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.

Add Feature Flag compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Feature Flag this skillcadence-workflow/cadence-web436—~1.1kAutomated safety check: NotesApache-2.0
Nodejs Backend Patternsever-works/ever-works16218 repos~4kAutomated safety check: PassAGPL-3.0
API DesignerJeffallan/claude-skills12k1 repos~2kAutomated safety check: PassMIT
GraphQL Operations with CodegenChrisWiles/claude-code-showcase6.1k3 repos~1.5kAutomated safety check: PassNone
Supabasecurvenote/curvenote1705 repos~2.2kAutomated safety check: PassCustom licence
API Design Principlesjh941213/my-cc-harness12618 repos~3.4kAutomated safety check: PassNone

Similar skills

  • Nodejs Backend Patterns

    ever-works/ever-works

    Build production-ready Node.js backend services with Express/Fastify, implementing middleware patterns, error handling, authentication, database integration, and API design best practices.

    162 GitHub starsUsed in 18 repos~4k tokens
    Backend & APIsAuto-check passed
  • API Designer

    Jeffallan/claude-skills

    Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.

    12k GitHub starsUsed in 1 repo~2k tokens
    Backend & APIsAuto-check passed
  • GraphQL Operations with Codegen

    ChrisWiles/claude-code-showcase

    Sets the rules for writing GraphQL queries and mutations in .gql files, running codegen, and using generated Apollo hooks with proper error and loading handling.

    6.1k GitHub starsUsed in 3 repos~1.5k tokens
    Backend & APIsAuto-check passed
  • Supabase

    curvenote/curvenote

    A skill your agent uses when doing ANY task involving Supabase.

    170 GitHub starsUsed in 5 repos~2.2k tokens
    Backend & APIsAuto-check passed
  • API Design Principles

    jh941213/my-cc-harness

    REST 및 GraphQL API 설계 원칙 가이드. An agent skill from jh941213/my-cc-harness.

    126 GitHub starsUsed in 18 repos~3.4k tokens
    Backend & APIsAuto-check passed
  • API And Interface Design

    dzhalaevd/Donatello

    Guides stable API and interface design. An agent skill from dzhalaevd/Donatello.

    135 GitHub starsUsed in 8 repos~2.6k tokens
    Backend & APIsAuto-check passed

More from cadence-workflow/cadence-web

  • React Joyride

    cadence-workflow/cadence-web

    Guide for implementing, configuring, and debugging React Joyride v3 guided tours.

    436 GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Add Feature Flag

What does Add Feature Flag do?

Add a new boolean feature flag (dynamic config key) to cadence-web. Add Feature Flag is an agent skill from cadence-workflow/cadence-web. Add a new boolean feature flag (dynamic config key) to cadence-web.

When should I use Add Feature Flag?

Add Feature Flag fits situations like: set up a feature flag; tasks that involve GraphQL.

How do I install Add Feature Flag in Claude Code?

Run `npx skills add cadence-workflow/cadence-web --skill add-feature-flag -a claude-code`. Or copy the skill folder (.agents/skills/add-feature-flag in cadence-workflow/cadence-web) into .claude/skills/add-feature-flag in your project. Claude Code loads it when a task matches its description.

How do I install Add Feature Flag in Codex?

Run `npx skills add cadence-workflow/cadence-web --skill add-feature-flag -a codex`. Or copy the skill folder (.agents/skills/add-feature-flag in cadence-workflow/cadence-web) into .agents/skills/add-feature-flag in your project. Codex loads it when a task matches its description.

Can I use Add Feature Flag 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 cadence-workflow/cadence-web --skill add-feature-flag -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-feature-flag, .gemini/skills/add-feature-flag, .github/skills/add-feature-flag and .opencode/skills/add-feature-flag in your project.

What does Add Feature Flag need to run?

Going by SKILL.md and its folder, Add Feature Flag needs the command-line tools its instructions call (npm and curl).

Does Add Feature Flag access the network?

SKILL.md contains no URLs. Its commands use npm and curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Add Feature Flag safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Add Feature Flag use?

Add Feature Flag is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Feature Flag use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Add Feature Flag?

Skills that share tags, products or a category with Add Feature Flag: Nodejs Backend Patterns (ever-works/ever-works, 162 stars), API Designer (Jeffallan/claude-skills, 12k stars), GraphQL Operations with Codegen (ChrisWiles/claude-code-showcase, 6.1k stars) and Supabase (curvenote/curvenote, 170 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Feature Flag?

cadence-workflow (a GitHub organization) maintains it in cadence-workflow/cadence-web, which has 436 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 8, 2026.

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