How do I install the Aio Tanca skill?

Run npx skillmds@latest add aiocean/aio-tanca in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Aio Tanca safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Aio Tanca?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Aio Tanca free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Aio Tanca?

aiocean (@aiocean) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Aio Tanca by aiocean — Agent Skill

Name: Aio Tanca
Author: aiocean

File contents

Tanca Skill

Employee timekeeping and HR operations via nguyenvanduocit/tanca-mcp.

Environment

Go: !which go 2>/dev/null || echo "NOT INSTALLED"
tanca-mcp: !which tanca-mcp 2>/dev/null || echo "NOT INSTALLED"
tanca-cli: !which tanca-cli 2>/dev/null || echo "NOT INSTALLED"
TANCA_TOKEN: ![ -n "$TANCA_TOKEN" ] && echo "SET" || echo "NOT SET"
TANCA_SHOP_ID: !echo ${TANCA_SHOP_ID:-NOT SET}
TANCA_BRANCH_ID: !echo ${TANCA_BRANCH_ID:-NOT SET}
MCP configured: !cat .mcp.json 2>/dev/null | grep -q tanca && echo "YES" || echo "NO"

Install (skip if already installed above)

go install github.com/nguyenvanduocit/tanca-mcp@latest
go install github.com/nguyenvanduocit/tanca-mcp/cmd/tanca-cli@latest

Add to .mcp.json:

{
  "mcpServers": {
    "tanca": {
      "command": "tanca-mcp",
      "env": {
        "TANCA_TOKEN": "Bearer your-token-here",
        "TANCA_SHOP_ID": "12345"
      }
    }
  }
}

Values needed: TANCA_TOKEN (format: Bearer your-token-here), TANCA_SHOP_ID (auto-fetched if omitted), TANCA_BRANCH_ID (optional). Restart Claude Code after configuring.

MCP Tools (prefix: `tanca_`)

Employee Management

Tool	Usage
`tanca_list_employees`	`()` — all employees
`tanca_list_timekeeping_employees`	`()` — employees requiring timekeeping

Shift Management

Tool	Usage
`tanca_list_shifts`	`()` — all shift assignments
`tanca_get_shift_summary`	`(employee_id: "123")`
`tanca_get_today_shift`	`(employee_id: "123")`

Check-in / Check-out

tanca_check_in(employee_id: "123")
tanca_check_out(employee_id: "123")

Clock Logs

tanca_get_clock_logs(employee_id: "123", from: "2025-01-01", to: "2025-01-31")

Shop Info

tanca_get_shop_info()

CLI (fallback if MCP not configured)

tanca-cli list-employees --env .env
tanca-cli list-timekeeping-employees --env .env
tanca-cli list-shifts --env .env
tanca-cli get-shift-summary --employee-id 123 --env .env
tanca-cli get-today-shift --employee-id 123 --env .env
tanca-cli check-in --employee-id 123 --env .env
tanca-cli check-out --employee-id 123 --env .env
tanca-cli get-clock-logs --employee-id 123 --from 2025-01-01 --to 2025-01-31 --env .env
tanca-cli get-shop-info --env .env

Flag: --env path to .env file with credentials.

Workflows

Daily Attendance Check

tanca_list_timekeeping_employees() — who needs to clock in
tanca_get_today_shift(employee_id: "123") — check expected shift
tanca_get_clock_logs(employee_id: "123", from: "2025-01-15", to: "2025-01-15") — verify attendance

Monthly Report

tanca_list_employees() — get all employees
For each employee: tanca_get_clock_logs(employee_id: "...", from: "2025-01-01", to: "2025-01-31")
tanca_get_shift_summary(employee_id: "...") — compare expected vs actual

---name: aio-tancadescription: Manage employee timekeeping, shifts, and attendance via tanca-mcp (auto-installs if missing).---# Tanca SkillEmployee timekeeping and HR operations via [nguyenvanduocit/tanca-mcp](https://github.com/nguyenvanduocit/tanca-mcp).## Environment- Go: !`which go 2>/dev/null || echo "NOT INSTALLED"`- tanca-mcp: !`which tanca-mcp 2>/dev/null || echo "NOT INSTALLED"`- tanca-cli: !`which tanca-cli 2>/dev/null || echo "NOT INSTALLED"`- TANCA_TOKEN: !`[ -n "$TANCA_TOKEN" ] && echo "SET" || echo "NOT SET"`- TANCA_SHOP_ID: !`echo ${TANCA_SHOP_ID:-NOT SET}`- TANCA_BRANCH_ID: !`echo ${TANCA_BRANCH_ID:-NOT SET}`- MCP configured: !`cat .mcp.json 2>/dev/null | grep -q tanca && echo "YES" || echo "NO"`## Install (skip if already installed above)```bashgo install github.com/nguyenvanduocit/tanca-mcp@latestgo install github.com/nguyenvanduocit/tanca-mcp/cmd/tanca-cli@latest```Add to `.mcp.json`:```json{ "mcpServers": { "tanca": { "command": "tanca-mcp", "env": { "TANCA_TOKEN": "Bearer your-token-here", "TANCA_SHOP_ID": "12345" } } }}```Values needed: `TANCA_TOKEN` (format: `Bearer your-token-here`), `TANCA_SHOP_ID` (auto-fetched if omitted), `TANCA_BRANCH_ID` (optional). Restart Claude Code after configuring.## MCP Tools (prefix: `tanca_`)### Employee Management| Tool | Usage ||------|-------|| `tanca_list_employees` | `()` — all employees || `tanca_list_timekeeping_employees` | `()` — employees requiring timekeeping |### Shift Management| Tool | Usage ||------|-------|| `tanca_list_shifts` | `()` — all shift assignments || `tanca_get_shift_summary` | `(employee_id: "123")` || `tanca_get_today_shift` | `(employee_id: "123")` |### Check-in / Check-out```tanca_check_in(employee_id: "123")tanca_check_out(employee_id: "123")```### Clock Logs```tanca_get_clock_logs(employee_id: "123", from: "2025-01-01", to: "2025-01-31")```### Shop Info```tanca_get_shop_info()```## CLI (fallback if MCP not configured)```bashtanca-cli list-employees --env .envtanca-cli list-timekeeping-employees --env .envtanca-cli list-shifts --env .envtanca-cli get-shift-summary --employee-id 123 --env .envtanca-cli get-today-shift --employee-id 123 --env .envtanca-cli check-in --employee-id 123 --env .envtanca-cli check-out --employee-id 123 --env .envtanca-cli get-clock-logs --employee-id 123 --from 2025-01-01 --to 2025-01-31 --env .envtanca-cli get-shop-info --env .env```Flag: `--env` path to .env file with credentials.## Workflows### Daily Attendance Check1. `tanca_list_timekeeping_employees()` — who needs to clock in2. `tanca_get_today_shift(employee_id: "123")` — check expected shift3. `tanca_get_clock_logs(employee_id: "123", from: "2025-01-15", to: "2025-01-15")` — verify attendance### Monthly Report1. `tanca_list_employees()` — get all employees2. For each employee: `tanca_get_clock_logs(employee_id: "...", from: "2025-01-01", to: "2025-01-31")`3. `tanca_get_shift_summary(employee_id: "...")` — compare expected vs actual

Frequently asked questions

Aio Tanca