@joktec/skills 0.1.0

package/skills/joktec-mysql-skill/references/entities.md

@@ -0,0 +1,15 @@
+# MySQL Entity Decorators
+
+## Schema-First Entity Pattern
+
+Use `@Tables`, `@Column`, and `@PrimaryColumn` from `@joktec/mysql` when an entity should also act as the source class for mapped DTOs.
+
+## Primary Keys
+
+- Prefer numeric auto-increment keys for write-heavy MySQL tables.
+- Use UUIDs when the app needs globally unique or public identifiers.
+- Prefer `uuidv7` over random UUIDs when the id participates in ordered indexes or cursor-like access.
+
+## Dialects
+
+The stable dialects are MySQL, MariaDB, and Postgres. Dialect capabilities own differences such as `LIKE` vs `ILIKE`, array support, fulltext support, and generated map reliability.

package/skills/joktec-mysql-skill/references/repository.md

@@ -0,0 +1,23 @@
+# MySQL Repository Usage
+
+## Module Setup
+
+Register entities with `MysqlModule.forRoot({ conId, models: [...] })`. Use `conId` for multiple DataSources.
+
+## Repository Pattern
+
+Extend `MysqlRepo` and pass the entity class to the base constructor. Services can use `BaseService` when CRUD behavior follows the shared contract.
+
+## Query Safety
+
+- Validate field paths against TypeORM metadata before interpolating SQL identifiers.
+- Use parameter binding for values.
+- Keep logical operators such as `$and` and `$or` grouped through QueryBuilder behavior.
+
+## Pagination
+
+`MysqlRepo.paginate` supports page, offset, and cursor responses. Cursor mode defaults to `createdAt` plus primary key columns. Custom cursor keys must be mapped columns.
+
+## Transactions
+
+When using transaction-scoped operations, pass the manager or query runner through repository options so pre-read and write operations use the same context.

package/skills/joktec-tool-skill/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: joktec-tool-skill
+description: Use when wiring or using JokTec tool packages @joktec/http, @joktec/file, or @joktec/alert, including Axios-backed HTTP clients, file classification helpers, Slack-compatible alert webhooks, config-driven lifecycle, and app-neutral utility services.
+---
+
+# JokTec Tool Skill
+
+Use this skill for reusable utility services.
+
+## Packages
+
+- `@joktec/http`: Axios-backed HTTP client wrapper.
+- `@joktec/file`: file classification and local file helpers.
+- `@joktec/alert`: alert delivery through Slack-compatible webhooks.
+
+## Rules
+
+- Keep tools app-neutral and reusable.
+- Use config-driven clients instead of direct ad hoc setup in app code.
+- Preserve retry, metrics, proxy, and upload behavior where the package exposes it.
+- Keep alert tokens and webhook URLs in runtime config only.
+
+## Reference
+
+Read `references/tools.md` for package-specific usage notes.

package/skills/joktec-tool-skill/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "JokTec Tools"
+  short_description: "Use JokTec utility tool packages"
+  default_prompt: "Use $joktec-tool-skill when using JokTec HTTP, file, or alert tools."

package/skills/joktec-tool-skill/references/tools.md

@@ -0,0 +1,13 @@
+# Tool Usage
+
+## HTTP
+
+Use `@joktec/http` for Axios-backed requests, uploads, proxy agent support, retry config, and metrics where exposed.
+
+## File
+
+Use `@joktec/file` for shared file helpers and classification behavior instead of duplicating local utility code.
+
+## Alert
+
+Use `@joktec/alert` for Slack-compatible webhook alerts. Keep webhook URLs and credentials out of source control.