Agent skill

Dial Docs

by epam in epam/ai-dial-chat

On-demand index of the AI DIAL Chat design docs in docs/. An agent skill from epam/ai-dial-chat.

Apache-2.0Auto-check passedBackend & APIs

Install Dial Docs

skills CLI
$ npx skills add epam/ai-dial-chat --skill dial-docs -a claude-code

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

GitHub CLI
$ gh skill install epam/ai-dial-chat dial-docs --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/epam/ai-dial-chat.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/dial-docs .claude/skills/dial-docs && 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
dial-docs
GitHub stars
504
Token cost
~1.6k tokens
SKILL.md length
346 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
Apache-2.0

At a glance

On-demand index of the AI DIAL Chat design docs in docs/. An agent skill from epam/ai-dial-chat.

  • Works in 2 steps: Match your task to a row above and open… → For auth work, start with…
  • You need ground-truth on how the app works
  • SKILL.md covers Index, How to use and Maintaining the index
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dial Docs is an agent skill from epam/ai-dial-chat. On-demand index of the AI DIAL Chat design docs in docs/. Use when you need ground-truth on how the app works or is built — overall architecture, technical/product requirements, the authentication subsystem (login, logout, OIDC, session cookies, encrypted session, transparent token refresh, BFF auth flow, SessionGuard), theme customization and color tokens, embedding the chat through the overlay, the Responses API integration, adopting the reusable chat workflows (skill import, file attachment, prompt selector)…

Its SKILL.md is about 1.6k 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 Authentication, Architecture decision records and OAuth and OpenID Connect. The repository describes itself as: A default UI for AI DIAL. The licence is Apache-2.0.

When your agent uses it

  • You need ground-truth on how the app works
  • Is built — overall architecture
  • Technical/product requirements
  • The authentication subsystem (login

Example prompts

  • “/dial-docs”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Match your task to a row above and open that one doc.
  2. For auth work, start with auth-bff-encrypted-cookie.md; use the diagrams for flow detail.

What it can do on your machine

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

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

  • Network

    No URLs in SKILL.md.

    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

Dial Docs loads about 1.6k tokens when it runs. Until then it costs about 160 tokens; SKILL.md has 346 words of instructions outside code blocks.

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

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 epam/ai-dial-chat at commit 2d66a8d, republished under its Apache-2.0 licence (© epam). 346 words, ~1,553 tokens.

Download SKILL.mdSave it as .claude/skills/dial-docs/SKILL.md (or your agent's skills folder).
name
dial-docs
description
On-demand index of the AI DIAL Chat design docs in docs/. Use when you need ground-truth on how the app works or is built — overall architecture, technical/product requirements, the authentication subsystem (login, logout, OIDC, session cookies, encrypted session, transparent token refresh, BFF auth flow, SessionGuard), theme customization and color tokens, embedding the chat through the overlay, the Responses API integration, adopting the reusable chat workflows (skill import, file attachment, prompt selector) in another host, or environment-variable migration. Resolves to the one relevant doc; do not preload all of them.

DIAL Docs

Ground-truth design docs live in docs/. This skill is the index. Open only the doc that matches your task — don't read all of them.

Index

DocRead it when
docs/architecture.mdOrienting on the overall app: structure, layers, major decisions.
docs/technical-requirements.mdYou need the product/technical requirements behind a feature.
docs/auth/auth-bff-encrypted-cookie.mdChanging the auth flow: stateless BFF, OIDC login/callback, encrypted session cookie, transparent refresh, federated logout, cross-pod stateless decryption.
docs/auth/testing-current-auth-implementation.mdWriting or running auth tests: what exists today (GET /api/v1/auth/me, global SessionGuard, refresh) and how to exercise it.
docs/auth/auth-diagrams/You need the picture: Mermaid .mmd + .svg for architecture, provider registry, login, refresh, logout, cross-pod, cookie structure.
docs/legacy-chat-migration-guide.mdMoving a deployment from the legacy DIAL Chat (0.x) to 1.0: what changed, the checklist, and the legacy → new environment-variable mapping.
docs/theme-customization.mdTheming: the themes service and config.json format, the color tokens the app reads, logos and favicon, the light/dark/system picker, legacy theme migration.
docs/chat-overlay-migration-guide.mdEmbedding the chat: the overlay package, postMessage protocol and handshake, OverlayFeature flags, and migrating from the legacy @epam/ai-dial-overlay.
docs/responses-api-integration.mdWorking on completions dispatch: how deployments declaring responses_api are routed and normalized.
docs/observability.mdConfiguring OpenTelemetry, interpreting HTTP/generation/runtime metrics, importing Grafana dashboards, or troubleshooting missing telemetry.
docs/host-install-matrix.mdAn embedding host asks what to put in its own package.json for a given set of libs. Generated from the manifests; do not hand-edit.
docs/reusable-chat-workflows.mdAdopting the reusable skill-import, file-attachment or prompt-selector workflows in another chat host: public imports, what the host keeps, release alignment, and what the packed fixtures do and do not prove.
apps/chat-api/README.mdThe full environment-variable reference: every supported variable, its default, and its effect. apps/chat-api/.env.template is the annotated source.

How to use

  1. Match your task to a row above and open that one doc.
  2. For auth work, start with auth-bff-encrypted-cookie.md; use the diagrams for flow detail.

Maintaining the index

Adding a doc to docs/ means adding a row here in the same change — an unindexed doc is one nobody finds. docs/architecture.md additionally has a standing update obligation (new lib, app, backend domain, context, route, or endpoint group); see the Docs section of AGENTS.md.

© epam, 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 .claude/skills/dial-docs of epam/ai-dial-chat.

Open the folder on GitHubat commit 2d66a8d

Compare with similar skills

Dial Docs 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.

Dial Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dial Docs this skillepam/ai-dial-chat504—~1.6kAutomated safety check: PassApache-2.0
Passport Developmenttrypostit/trypost678—~1.9kAutomated safety check: PassMIT
OneCLI Gatewaynanocoai/nanoclaw31k1 repos~856Automated safety check: PassMIT
Frappe Core APIImpertio-Studio/Frappe_Claude_Skill_Package1871 repos~3.2kAutomated safety check: PassMIT
Soundcloud API Integrationsoundcloud/api258—~787Automated safety check: PassNone
Quarkus Securityaffaan-m/ECC275k1 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • Passport Development

    trypostit/trypost

    Develops OAuth2 API authentication with Laravel Passport. An agent skill from trypostit/trypost.

    678 GitHub stars~1.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • OneCLI Gateway

    nanocoai/nanoclaw

    Explains how to call external APIs through the OneCLI proxy, which injects stored credentials into outgoing HTTPS requests so the agent never handles keys.

    31k GitHub starsUsed in 1 repo~856 tokens
    Backend & APIsAuto-check passed
  • Frappe Core API

    Impertio-Studio/Frappe_Claude_Skill_Package

    A skill your agent uses when building ERPNext/Frappe API integrations (v14/v15/v16) including REST API, RPC API, authentication, webhooks, and rate limiting.

    187 GitHub starsUsed in 1 repo~3.2k tokens
    Backend & APIsAuto-check passed
  • Integrates applications with the SoundCloud HTTP API using OAuth 2.1, OpenAPI, and developer docs.

    258 GitHub stars~787 tokensUpdated 7 days ago
    Backend & APIsAuto-check passed
  • Quarkus Security

    affaan-m/ECC

    Quarkus security implementation patterns: JWT and OIDC authentication, @RolesAllowed RBAC and SecurityIdentity checks, Bean Validation and custom validators, parameterized Panache queries, BCrypt…

    275k GitHub starsUsed in 1 repo~3.1k tokens
    Backend & APIsAuto-check passed
  • Security Patterns

    CloudAI-X/claude-workflow-v2

    Implements authentication, authorization, encryption, secrets management, and security hardening patterns.

    1.4k GitHub stars~3.6k tokensUpdated yesterday
    Backend & APIsAuto-check: notes

More from epam/ai-dial-chat

All 18 skills in this repo
  • Refactoring Audit

    epam/ai-dial-chat

    Deep codebase refactoring audit for AI DIAL Chat. An agent skill from epam/ai-dial-chat.

    504 GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Read unresolved GitHub code review threads for the pull request associated with the current branch, classify each comment, and implement and verify required code fixes.

    504 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Create Ticket

    epam/ai-dial-chat

    Interactively create OR update GitHub issues (Bug, Feature, Task) for the current repository.

    504 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Dep Scan

    epam/ai-dial-chat

    Runs Trivy filesystem scan against the repo root and emits structured vulnerability findings (CVE, package, versions) in the SDLC reviewer schema.

    504 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Figma

    epam/ai-dial-chat

    Design-to-code workflow for Figma designs. An agent skill from epam/ai-dial-chat.

    504 GitHub stars~997 tokensUpdated today
    Auto-check passed
  • Git Ship

    epam/ai-dial-chat

    A skill your agent uses whenever the user wants to commit, push, or ship changes in a git repository.

    504 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Dial Docs

What does Dial Docs do?

On-demand index of the AI DIAL Chat design docs in docs/. An agent skill from epam/ai-dial-chat. Dial Docs is an agent skill from epam/ai-dial-chat. On-demand index of the AI DIAL Chat design docs in docs/.

When should I use Dial Docs?

Dial Docs fits situations like: you need ground-truth on how the app works; is built — overall architecture; technical/product requirements; the authentication subsystem (login.

How do I install Dial Docs in Claude Code?

Run `npx skills add epam/ai-dial-chat --skill dial-docs -a claude-code`. Or copy the skill folder (.claude/skills/dial-docs in epam/ai-dial-chat) into .claude/skills/dial-docs in your project. Claude Code loads it when a task matches its description.

How do I install Dial Docs in Codex?

Run `npx skills add epam/ai-dial-chat --skill dial-docs -a codex`. Or copy the skill folder (.claude/skills/dial-docs in epam/ai-dial-chat) into .agents/skills/dial-docs in your project. Codex loads it when a task matches its description.

Can I use Dial Docs 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 epam/ai-dial-chat --skill dial-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dial-docs, .gemini/skills/dial-docs, .github/skills/dial-docs and .opencode/skills/dial-docs in your project.

What does Dial Docs need to run?

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

Does Dial Docs access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Dial Docs 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 Dial Docs use?

Dial Docs 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 Dial Docs use?

About 1.6k tokens (SKILL.md is roughly 6.2k 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 Dial Docs?

Skills that share tags, products or a category with Dial Docs: Passport Development (trypostit/trypost, 678 stars), OneCLI Gateway (nanocoai/nanoclaw, 31k stars), Frappe Core API (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars) and Soundcloud API Integration (soundcloud/api, 258 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dial Docs?

epam (a GitHub organization) maintains it in epam/ai-dial-chat, which has 504 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: epam/ai-dial-chat on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.