digirati-co-uk/automation-bots
.agents/skills/automation-bots/SKILL.md
Work on Madoc TS automation bots, bot definitions, and task event handling. Use when adding new bots, updating bot triggers, or changing bot execution flows in services/madoc-ts.
$ install --global
skillsauthnpx skillsauth add digirati-co-uk/madoc-platform automation-botsInstall 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: Apr 16, 2026, 3:52 PM5.5s2 files scanned
SKILL.md
- name:
- automation-bots
- description:
- Work on Madoc TS automation bots, bot definitions, and task event handling. Use when adding new bots, updating bot triggers, or changing bot execution flows in services/madoc-ts.
Automation Bots (Madoc TS)
Goal
Explain how automation bots are defined and invoked so new bots and task handlers integrate safely.
Scope
- Bot definitions and metadata
- Bot execution and task event handling
- Manual bot actions
Non-scope
- Queue worker infrastructure
- Cron job orchestration
- General task definitions outside automation
Key Entry Points
services/madoc-ts/src/automation/bot-definitions.tsservices/madoc-ts/src/automation/bots/services/madoc-ts/src/automation/index.tsservices/madoc-ts/src/automation/utils/BaseAutomation.tsservices/madoc-ts/src/automation/utils/ManualActions.tsservices/madoc-ts/src/automation/utils/TaskAutomation.ts
Architecture Summary (Based on Source)
- Bots are listed in
bot-definitions.tswith metadata and site role. automation/index.tsmaps task events to bots and executes them as automated users.BaseAutomationenforces automated-user checks and exposes config, task, and manual action hooks.AutomaticReviewBotlistens forcrowdsourcing-reviewevents and auto-approves tasks when configured.
Quick Start Workflow
- Review
services/madoc-ts/src/automation/index.tsto understand how bots are dispatched for task events. - Inspect
services/madoc-ts/src/automation/bots/for existing bot patterns. - Add bot metadata to
services/madoc-ts/src/automation/bot-definitions.tsand register the class inautomation/index.ts.
Common Tasks
- Add a new automation bot type
- Update bot event triggers or actions
- Extend manual bot actions
Pitfalls
- Forgetting to register bot class in
automation/index.ts - Missing automated user configuration for a bot
- Triggering bot actions without required task fields
Suggested Checks
- Trigger a supported task event and verify bot execution
- Run manual bot action if applicable
Related Skills
digirati-co-uk/utility-core
tools
VerifiedTrustedCommunity
Work on Madoc TS shared utility helpers (JWT, metadata, errors, IIIF helpers, auth helpers). Use when changing core utility functions or shared helpers in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/types-schemas
development
VerifiedTrustedCommunity
Work on Madoc TS shared type definitions and schema contracts. Use when updating TypeScript types, JSON schema shapes, or cross-layer data contracts in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/tasks-automation
tools
VerifiedTrustedCommunity
Understand and extend Madoc TS task automation, including bots and task-related extensions. Use when adding task automation, bot behavior, or task metadata resolution in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026
digirati-co-uk/ssr-site
development
VerifiedTrustedCommunity
Work on Madoc TS site SSR pipeline, HTML template injection, and site render data wiring. Use when changing site SSR behavior, template tokens, or site SSR data wiring in services/madoc-ts.
56SKILL.mdUpdated Apr 16, 2026