Agent skill

Deskcomm Doutrina

by melgarafael in melgarafael/DeskcommCRM

Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host.

MITAuto-check passedBackend & APIs

Install Deskcomm Doutrina

skills CLI
$ npx skills add melgarafael/DeskcommCRM --skill deskcomm-doutrina -a claude-code

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

GitHub CLI
$ gh skill install melgarafael/DeskcommCRM deskcomm-doutrina --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/melgarafael/DeskcommCRM.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/deskcomm-doutrina .claude/skills/deskcomm-doutrina && 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
deskcomm-doutrina
GitHub stars
4.5k
Token cost
~981 tokens
SKILL.md length
545 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host.

  • Works in 4 steps: Leia antes de escrever → As três que mais custam → O eixo que não é técnico → …
  • Tasks that involve Multi-tenancy
  • SKILL.md covers 1. Leia antes de escrever, 2. As três que mais custam, 3. O eixo que não é técnico and 4. Antes de dizer "pronto", plus 1 more section
  • Calls pnpm

What it does

Deskcomm Doutrina is an agent skill from melgarafael/DeskcommCRM. Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host. USE SEMPRE ao escrever ou revisar código neste repositório, e antes de responder pergunta sobre convenção, schema, tenancy, WhatsApp/WAHA, instalador ou Definition of Done. É o ponteiro para a doutrina viva do repo; não substitui ler o CLAUDE.md.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Backend & APIs, covering Multi-tenancy and Agent instruction files. It works with WhatsApp and Supabase. The repository describes itself as: Open-source AI sales OS — self-hosted CRM with native AI agents + WhatsApp (WAHA). Open alternative to Kommo, Octadesk & Intercom for any business that sells by chat. MCP-ready… The licence is MIT.

When your agent uses it

  • Tasks that involve Multi-tenancy
  • Tasks that involve Agent instruction files

Example prompts

  • “/deskcomm-doutrina”

Workflow steps

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

  1. Leia antes de escrever
  2. As três que mais custam
  3. O eixo que não é técnico
  4. Antes de dizer "pronto"

What it can do on your machine

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

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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

Deskcomm Doutrina loads about 981 tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 545 words of instructions outside code blocks.

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

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 melgarafael/DeskcommCRM at commit b3bd604, republished under its MIT licence (© melgarafael). 545 words, ~981 tokens.

Download SKILL.mdSave it as .claude/skills/deskcomm-doutrina/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
deskcomm-doutrina
description
Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host. USE SEMPRE ao escrever ou revisar código neste repositório, e antes de responder pergunta sobre convenção, schema, tenancy, WhatsApp/WAHA, instalador ou Definition of Done. É o ponteiro para a doutrina viva do repo; não substitui ler o CLAUDE.md.

DeskcommCRM — doutrina de código

A fonte da verdade é o CLAUDE.md da raiz, lido do origin/main e não de um resumo. Esta skill existe para te fazer abri-lo na hora certa e para carregar as três regras que mais custam caro quando esquecidas.

1. Leia antes de escrever

arquivoquando
CLAUDE.mdsempre, antes de qualquer código — contém a Definition of Done, que muda
VISION.mdantes de decidir escopo, ou de dizer não a uma feature
docs/doctrine/ao mexer em canal, agente, ou peça que se conecte a outra
ARCHITECTURE.mdpara a visão de uma página

Não confie em resumo de doutrina — nem neste arquivo. A Definition of Done já foi de 13 para 14 itens; cópia congelada ensina a regra de ontem. Abra o CLAUDE.md.

2. As três que mais custam

Multi-tenancy. Toda tabela tenant-aware leva organization_id uuid not null e RLS com policy tenant_isolation_<tabela>_all via fn_user_org_ids(). Service role bypassa RLS — handler que o usa filtra organization_id manualmente, resolvido de fonte confiável (cookie, JWT, segredo de webhook, token de path), nunca do body. No backend é sempre getUser(), nunca getSession().

Schema sai em tripla. Arquivo em supabase/migrations/, apêndice idempotente no supabase/baseline.sql, e linha -- manifest: <o quê e por quê> no cabeçalho do .sql (o MANIFEST.md é histórico; não recebe linha nova). O kit self-host aplica só o baseline — o que não chega lá não chega em quem instalou numa VPS, que é o cliente que paga. Constraint nova exige corrigir os dados antes, senão o update.sh do clone quebra.

Nenhuma feature nomeia um provider. Provider vive em lib/channels/. pnpm lint:channels é catraca com lista de dívida: arquivo novo sujo reprova — e arquivo que ficou limpo e não saiu da lista também reprova.

3. O eixo que não é técnico

A monetização é self-host em VPS, não assinatura: quem instala é o cliente. Então uma mudança pode ser tecnicamente impecável e ainda assim ser recusada — env var nova sem default quebra instalação fresca, dependência de serviço pago obrigatório quebra o modelo, e a pior de todas é a falha-em-verde: a sonda que declara sucesso medindo caminho diferente do que o usuário usa. Num produto que a pessoa instala sozinha, ela não descobre que está quebrado.

Show full SKILL.md (181 more words)Show less

4. Antes de dizer "pronto"

Verde de teste não é prova de comportamento. Sabote a linha que você corrigiu e confirme que a suíte fica vermelha — teste que não reprova não guarda nada. E declare o que não mediu: é o campo que separa medição de relato.

E se o caminho de usuário que você provou passa por um agente de IA, o verde do agente não é prova da camada de baixo: todo caso de aceite que atravessa o agente vem em par com a medição direta da ferramenta, com o mesmo texto cru — o par é a unidade — e as duas medições só contam quando concordam. Discordância entre os dois significa que você mediu o modelo. Lei em docs/doctrine/prova-em-par.md.

Não-objetivos

Não lista comandos de fluxo — não existem /fix-bug nem /add-module neste repo. Não descreve estrutura de pastas nem convenção de nome de arquivo: a versão anterior deste arquivo era gerada automaticamente e ensinava snake_case com imports relativos, quando o repo usa kebab-case com alias @/. Detalhe correto mora no CLAUDE.md, que está atualizado — o que este arquivo não pode prometer.

© melgarafael, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/deskcomm-doutrina of melgarafael/DeskcommCRM.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit b3bd604

Compare with similar skills

Deskcomm Doutrina 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.

Deskcomm Doutrina compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deskcomm Doutrina this skillmelgarafael/DeskcommCRM4.5k—~981Automated safety check: PassMIT
Stash Zerokmscipherstash/stack157—~4.4kAutomated safety check: PassMIT
Supabase Architecture Variantsjeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: PassMIT
Supabase Reference Architecturejeremylongshore/tons-of-skills-marketplace2.8k—~2.9kAutomated safety check: NotesMIT
Authaiskillstore/marketplace433—~1.6kAutomated safety check: PassNone
Gingiris B2b GrowthGingiris-1031/Competitor-analysis-tool110—~1.2kAutomated safety check: PassNone

Similar skills

  • Stash Zerokms

    cipherstash/stack

    The ZeroKMS key model — keysets, clients, client keys, and the grant/revoke lifecycle.

    157 GitHub stars~4.4k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Supabase Architecture Variants

    jeremylongshore/tons-of-skills-marketplace

    A skill your agent uses when choosing how to integrate Supabase into a specific stack — setting up Next.js SSR auth flows, wiring an SPA or React Native client, configuring mobile deep links, or…

    2.8k GitHub stars~1.9k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Supabase Reference Architecture

    jeremylongshore/tons-of-skills-marketplace

    Implement enterprise Supabase reference architectures — monorepo layout, multi-tenant RLS, microservices with cross-project access, framework integration, edge functions, caching, queue patterns…

    2.8k GitHub stars~2.9k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Auth

    aiskillstore/marketplace

    Authentication and access control skill for Next.js 15 + Supabase applications.

    433 GitHub stars~1.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Gingiris B2b Growth

    Gingiris-1031/Competitor-analysis-tool

    🇺🇸 B2B SaaS Growth — PLG vs SLG Playbook — Diagnose whether your problem is distribution, pricing, or PMF.

    110 GitHub stars~1.2k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Database

    gridaco/grida

    Use BEFORE editing any file in supabase/migrations/ or supabase/schemas/, OR when the user runs a /database subcommand (compact local migration, rls scenarios, align).

    2.7k GitHub stars~3.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from melgarafael/DeskcommCRM

All 8 skills in this repo
  • Deskcomm Contribuir

    melgarafael/DeskcommCRM

    Guia de contribuição ao DeskcommCRM para quem vai mexer no código e abrir um pull request, sobretudo de um fork.

    4.5k GitHub stars~3.6k tokensUpdated today
    Auto-check: notes
  • Deskcomm Extensao

    melgarafael/DeskcommCRM

    Guia para criar uma extensão do DeskcommCRM — o pacote declarativo — em vez de abrir um PR no núcleo.

    4.5k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Deskcomm Metricas

    melgarafael/DeskcommCRM

    Guia de análise das métricas de uma instalação do DeskcommCRM como um analista de dados experiente — conversão, funil, tempo de resposta, handoff, follow-ups, custo de IA, motivos de perda, horários…

    4.5k GitHub stars~1.6k tokensUpdated today
    Auto-check: notes
  • Sistema Vivo

    melgarafael/DeskcommCRM

    Doutrina de arquitetura do Sistema Vivo — o método para construir software em que nada morre por falta de resposta, resolução ou visibilidade.

    4.5k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Deskcomm Cliente Novo

    melgarafael/DeskcommCRM

    Guia para montar um cliente novo no DeskcommCRM por nicho — clínica, imobiliária, serviços/agência, curso/infoproduto, loja, escritório de advocacia — criando os agentes de IA, roteadores…

    4.5k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Deskcomm Operacao

    melgarafael/DeskcommCRM

    Guia de operação diária do DeskcommCRM para quem já tem o sistema instalado e precisa encontrar telas, entender fluxos, configurar recursos correntes e resolver dúvidas de uso sem mexer no código.

    4.5k GitHub stars~826 tokensUpdated today
    Auto-check passed

Questions about Deskcomm Doutrina

What does Deskcomm Doutrina do?

Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host. Deskcomm Doutrina is an agent skill from melgarafael/DeskcommCRM. Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host.

When should I use Deskcomm Doutrina?

Deskcomm Doutrina fits situations like: tasks that involve Multi-tenancy; tasks that involve Agent instruction files.

How do I install Deskcomm Doutrina in Claude Code?

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

How do I install Deskcomm Doutrina in Codex?

Run `npx skills add melgarafael/DeskcommCRM --skill deskcomm-doutrina -a codex`. Or copy the skill folder (.agents/skills/deskcomm-doutrina in melgarafael/DeskcommCRM) into .agents/skills/deskcomm-doutrina in your project. Codex loads it when a task matches its description.

Can I use Deskcomm Doutrina 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 melgarafael/DeskcommCRM --skill deskcomm-doutrina -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/deskcomm-doutrina, .gemini/skills/deskcomm-doutrina, .github/skills/deskcomm-doutrina and .opencode/skills/deskcomm-doutrina in your project.

What does Deskcomm Doutrina need to run?

Going by SKILL.md and its folder, Deskcomm Doutrina needs the command-line tools its instructions call (pnpm).

Does Deskcomm Doutrina 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 Deskcomm Doutrina 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 Deskcomm Doutrina use?

Deskcomm Doutrina 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 Deskcomm Doutrina use?

About 981 tokens (SKILL.md is roughly 3.9k 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 Deskcomm Doutrina?

Skills that share tags, products or a category with Deskcomm Doutrina: Stash Zerokms (cipherstash/stack, 157 stars), Supabase Architecture Variants (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Supabase Reference Architecture (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Auth (aiskillstore/marketplace, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deskcomm Doutrina?

melgarafael (a GitHub user) maintains it in melgarafael/DeskcommCRM, which has 4,530 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 11, 2026.

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