sytex

by @Sytex in Web & API

# Install this skill:

npx skills add Sytex/agent-skills --skill "sytex"

Install specific skill from multi-skill repository

# Description

Connect to Sytex platform API. Use when user mentions Sytex, app, claro, ufinet, dt, adc, atis, exsei, integrar, torresec, or app_eu instances. Handles tasks, projects, forms, materials, organizations, and chats.

# SKILL.md

name: sytex
description: Connect to Sytex platform API. Use when user mentions Sytex, app, claro, ufinet, dt, adc, atis, exsei, integrar, torresec, or app_eu instances. Handles tasks, projects, forms, materials, organizations, and chats.
allowed-tools:
- Read
- Bash(~/.claude/skills/sytex/:)

Sytex API Integration

Manage tasks, projects, sites, materials, forms, chats, and automations via the Sytex API.

Required Flags

Every command (except find-org) requires:

~/.claude/skills/sytex/sytex --base-url <URL> --org <ID> <command>

Always ask user for confirmation before executing commands.

Finding the org

If user provides org name instead of ID, use find-org first:

~/.claude/skills/sytex/sytex find-org "Telecom Argentina"

Instances: app, app_eu, claro, ufinet, dt, adc, atis, exsei, integrar, torresec (all at https://<name>.sytex.io, except app_eu: https://app.eu.sytex.io)

Commands

All commands: ~/.claude/skills/sytex/sytex --base-url <URL> --org <ID> <command>

Tasks

Command	Description
`tasks [flags]`	List tasks
`task <id>`	Get task details
`task-update <id> <json>`	Update task (PATCH)
`task-status <code> <status>`	Update status by code
`task-create <json>`	Create task

Projects & Sites

Command	Description
`projects [flags]`	List projects
`project <id>`	Get project details
`sites [flags]`	List sites
`site <id>`	Get site details

Materials

Command	Description
`materials [flags]`	List materials
`material-ops [flags]`	List material operations
`mo-status <code> <status>`	Update MO status
`mo-add-item <json>`	Add item to MO

Forms

Command	Description
`forms [flags]`	List form instances
`form <id>`	Get form details

Staff

Command	Description
`staff [flags]`	List staff members
`user-roles <name>`	Get roles for a user

Automations

Command	Description
`automation <uuid> [json]`	Execute automation

Task Templates

Two types exist - ask user which one or search both:

Type	Command	Endpoint
Simple templates	`tasktemplates`, `tasktemplate <id>`	`/api/tasktemplate/`
Workflow tasks	`workstructure-tasks`, `workstructure-task <id>`	`/api/workstructuretask/`

Workstructures (Workflows)

Command	Description
`workstructures [flags]`	List workstructures
`workstructure <id>`	Get workstructure details

Custom Fields

Command	Description
`customfields --model MODEL --object-id ID`	Get custom fields

Models: workstructure, task, project, site, client, staff, form, materialoperation

Organizations

Command	Requires	Description
`find-org <name>`	(none)	Search across ALL instances
`orgs [--q QUERY]`	`--base-url` only	List orgs in one instance

Chat

Command	Description
`chats [flags]`	Search chats
`chat <id>`	Get chat details
`chat-create <json>`	Create chat
`chat-update <id> <json>`	Update chat title
`chat-messages <id> [flags]`	Get chat messages
`chat-send <id> <message>`	Send text message
`chat-send-json <id> <json>`	Send message with JSON (for files/replies)
`chat-mark-read <id>`	Mark chat as read
`chat-add-participant <id> <json>`	Add participant
`chat-remove-participant <id> <json>`	Remove participant
`chat-close <id>`	Close chat
`chat-reopen <id>`	Reopen chat
`chat-unread-counts`	Get unread counts
`chat-board [flags]`	Get chat board
`chat-teams [flags]`	List chat teams

Generic Endpoints

Command	Description
`get <endpoint>`	GET any endpoint
`post <endpoint> [json]`	POST to any endpoint
`patch <endpoint> <json>`	PATCH any endpoint
`delete <endpoint>`	DELETE any endpoint

Common Flags

Flag	Description
`--limit <n>`	Results per page
`--offset <n>`	Skip first N results
`--q <query>`	Search text
`--ordering <field>`	Sort (prefix `-` for desc)

Examples

# Find org across all instances
~/.claude/skills/sytex/sytex find-org "TMA"

# List tasks
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 tasks --limit 10

# Get task template (simple)
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 217 tasktemplate 1045

# Get workflow task template
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 217 workstructure-task 1045

# Execute automation
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 automation "uuid-here" '{"key": "value"}'

# Search chats
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chats --q "proyecto"

# Search chats related to a task
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chats --related-type task --related-id 12345

# Get chat messages
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chat-messages 100 --limit 20

# Send message
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chat-send 100 "Hello from CLI"

# Create chat
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chat-create '{"title": "New chat", "participants": [{"type": "user", "id": 5}]}'

# Add participant to chat
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chat-add-participant 100 '{"user_id": 5}'

# Close chat
~/.claude/skills/sytex/sytex --base-url https://app.sytex.io --org 141 chat-close 100

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.