konecty/konecty-modules
skills/konecty-modules/SKILL.md
Lists Konecty modules the current session has read access to, and retrieves fields and types for a specific module. Use when the user asks what modules or documents are available in Konecty, wants to know the fields/types of a module, needs to find the internal name of a module (e.g. "contatos", "clientes", "Oportunidade"), or wants to understand what data is accessible. Requires an active session from the konecty-session skill (KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env).
tools
Updated May 1, 2026
$ install --global
skillsauthnpx skillsauth add konecty/skills konecty-modulesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 9:43 AM154.1s2 files scanned
SKILL.md
- name:
- konecty-modules
- description:
- Lists Konecty modules the current session has read access to, and retrieves fields and types for a specific module. Use when the user asks what modules or documents are available in Konecty, wants to know the fields/types of a module, needs to find the internal name of a module (e.g. "contatos", "clientes", "Oportunidade"), or wants to understand what data is accessible. Requires an active session from the konecty-session skill (KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env).
Konecty Modules
Lists accessible Konecty modules and their fields/types for the current session.
Prerequisites
Requires credentials from konecty-session: KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env.
If not present or expired, ask the user to run konecty-session first.
API
All requests require Authorization: <KONECTY_TOKEN> header.
| Endpoint | Description |
|----------|-------------|
| GET /rest/query/explorer/modules?lang=pt_BR | All modules accessible to the current user, with fields and types |
Module object (lang controls field/module labels):
{
"document": "Contact",
"label": "Contato",
"fields": [
{ "name": "name", "type": "text", "label": "Nome" },
{ "name": "status", "type": "picklist", "label": "Status", "options": { "active": "Ativo" } },
{ "name": "queue", "type": "lookup", "label": "Fila", "document": "Queue", "descriptionFields": ["name"] }
],
"reverseLookups": [
{ "document": "Activity", "lookup": "contact", "label": "Atividade" }
]
}
Field types: text, number, boolean, date, dateTime, lookup, inheritLookup, picklist, address, file, url, email, phone, money, percentage, richText, autoNumber, filter.
Workflow
1. Load credentials
source ~/.konecty/.env # exports KONECTY_URL and KONECTY_TOKEN
Or use the script (auto-loads from ~/.konecty/.env).
2. List modules
python3 scripts/modules.py list
python3 scripts/modules.py list --lang en
Output: table of document (internal name), label, field count.
3. Find a module and show its fields
python3 scripts/modules.py fields "contato"
python3 scripts/modules.py fields "Contact"
python3 scripts/modules.py fields "oport" # fuzzy match
Matching priority: exact document name → exact label → fuzzy (difflib SequenceMatcher on document + label). Prints all fields with name, type, and label.
4. Search modules by keyword
python3 scripts/modules.py search "atividade"
Filters modules whose document or label contains the keyword (case-insensitive).
Fuzzy matching for agents
When the user refers to a module by an approximate name or in Portuguese, use python3 scripts/modules.py fields "<user term>" — the script ranks by similarity and picks the best match. If no confident match, it prints the top candidates so you can ask the user to confirm.
Script reference
See scripts/modules.py. Stdlib only (urllib, json, difflib, configparser).
All subcommands accept:
--host— overridesKONECTY_URL--token— overridesKONECTY_TOKEN--lang— language for labels (default:pt_BR)
Related Skills
konecty/template-skill
data-ai
VerifiedTrustedCommunity
Replace with description of the skill and when the agent should use it.
SKILL.mdUpdated May 1, 2026
konecty/konecty-upload
tools
VerifiedTrustedCommunity
Upload, list, and delete files in Konecty document fields via the file API. Use this skill whenever the user wants to attach a file to a Konecty record, upload a photo/image to a contact or product, add a PDF or document to an opportunity, send a curriculum to a candidate, manage gallery images for a development or promotion, or attach any binary file to any Konecty module field. Also triggers when the user says 'upload', 'anexar', 'enviar arquivo', 'adicionar imagem', 'attach file', or refers to file-type fields in any document. Automatically reads field constraints (accepted extensions, max size, max file count) from metadata before uploading to catch errors early. Requires an active konecty-session (KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env or ~/.konecty/credentials).
SKILL.mdUpdated May 1, 2026
konecty/konecty-update
documentation
VerifiedTrustedCommunity
Updates records in any Konecty module via PUT /rest/data/:document. Enforces the mandatory pre-update fetch workflow: always fetch the current record first to obtain its _updatedAt (optimistic locking guard), then PUT with ids=[{_id, _updatedAt}] and data={changed fields}. Use when the user wants to update, edit, change, or modify any record in Konecty. Requires an active konecty-session. Use konecty-modules to discover field names and types before updating.
SKILL.mdUpdated May 1, 2026
konecty/konecty-session
development
VerifiedTrustedCommunity
Opens a Konecty session via OTP login (request OTP, then verify OTP) and persists the access token in .env or ~/.konecty/credentials for use by other skills. Use when the user wants to log in to Konecty with OTP, store credentials, set up KONECTY_TOKEN, or establish a session so other Konecty skills can call the API. Only works when the namespace has OTP enabled (email or WhatsApp).
SKILL.mdUpdated May 1, 2026