konecty/konecty-meta-read
skills/konecty-meta-read/SKILL.md
Read Konecty metadata: list documents, get document/list/view/access/pivot/hook definitions, inspect meta types. Use when the user wants to see what metadata exists, inspect a document schema, read access profiles, view hook code, or understand metadata structure. Requires admin credentials from konecty-session.
development
Updated May 1, 2026
$ install --global
skillsauthnpx skillsauth add konecty/skills konecty-meta-readInstall 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:42 AM146.9s3 files scanned
SKILL.md
- name:
- konecty-meta-read
- description:
- Read Konecty metadata: list documents, get document/list/view/access/pivot/hook definitions, inspect meta types. Use when the user wants to see what metadata exists, inspect a document schema, read access profiles, view hook code, or understand metadata structure. Requires admin credentials from konecty-session.
Konecty Meta Read
Read-only access to all Konecty metadata types via the admin API.
Prerequisites
Requires admin credentials from konecty-session: KONECTY_URL and KONECTY_TOKEN in ~/.konecty/.env.
The authenticated user must have admin: true.
API Endpoints
All endpoints require Authorization: <KONECTY_TOKEN> header. All are admin-only.
| Endpoint | Description |
|----------|-------------|
| GET /api/admin/meta | List all document/composite metas (summary) |
| GET /api/admin/meta/:document | List all meta objects for a document (summary) |
| GET /api/admin/meta/:document/:type/:name | Get full meta by type and name |
| GET /api/admin/meta/:document/hook/:hookName | Get hook code (JS) or JSON (validationData) |
Workflow
1. List all documents
python3 scripts/meta_read.py list
python3 scripts/meta_read.py list --format json
2. Inspect all metas for a document
python3 scripts/meta_read.py get Contact
Returns summary of all metas: document, lists, views, access profiles, pivots, cards.
3. Get a specific meta
python3 scripts/meta_read.py get Contact --type list --name Default
python3 scripts/meta_read.py get Contact --type view --name Default
python3 scripts/meta_read.py get Contact --type access --name Corretor
python3 scripts/meta_read.py get Namespace --type namespace --name Namespace
4. Read hook code
python3 scripts/meta_read.py hook Contact scriptBeforeValidation
python3 scripts/meta_read.py hook Product validationData
python3 scripts/meta_read.py hook Contact validationScript
python3 scripts/meta_read.py hook Contact scriptAfterSave
5. List meta types for a document
python3 scripts/meta_read.py types Contact
Shows all meta types and their IDs grouped by type.
Meta types
| Type | _id pattern | Example |
|------|--------------|---------|
| document | {Name} | Contact |
| composite | {Name} | Education |
| list | {Doc}:list:{Name} | Contact:list:Default |
| view | {Doc}:view:{Name} | Contact:view:Default |
| access | {Doc}:access:{Name} | Contact:access:Corretor |
| pivot | {Doc}:pivot:{Name} | Contact:pivot:Default |
| card | {Doc}:card:{Name} | Opportunity:card:Default |
| namespace | Namespace | Namespace |
Detailed schema reference
See references/meta-schemas.md for full schema documentation with annotated examples for each type.
Script reference
See scripts/meta_read.py. Stdlib only (urllib, json).
All subcommands accept:
--host— overridesKONECTY_URL--token— overridesKONECTY_TOKEN
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