From 5b8bf36e712db23fdeb4aa18d10d60603d7ce02b Mon Sep 17 00:00:00 2001 From: Harjun751 Date: Mon, 2 Feb 2026 21:11:02 +0800 Subject: [PATCH 1/4] Add AI-tool-specific exclusions to .gitignore To support workflow for setting up skills locally, a symlink is suggested to be created in the root directory. These files should not be committed. Add common directories for skills configuration. --- .gitignore | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 354522f152..32ae0a3d42 100644 --- a/.gitignore +++ b/.gitignore @@ -109,4 +109,9 @@ packages/core/src/lib/progress/*.js # Nx for Lerna .nx/cache -.nx/workspace-data \ No newline at end of file +.nx/workspace-data + +# AI tool-specific configuration +.opencode +.claude +.cline From ef98cfe13a5db82f35b07ce7757c0208207d0727 Mon Sep 17 00:00:00 2001 From: Harjun751 Date: Mon, 2 Feb 2026 21:12:43 +0800 Subject: [PATCH 2/4] Update AI use guide on setting up skills properly Docs mention that skills live in .github/skills but most if not all tools don't support this. Add information on how to set up a symlink to get desired skill functionality. --- docs/devGuide/development/aiUse.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/devGuide/development/aiUse.md b/docs/devGuide/development/aiUse.md index c89256645d..dbfc2862c7 100644 --- a/docs/devGuide/development/aiUse.md +++ b/docs/devGuide/development/aiUse.md @@ -15,11 +15,16 @@ The MarkBind project has configurations that facilitate AI use. ## AI Skills -Skills are designed to improve AI agent performance by providing structured instructions and resources for specific tasks. This is applicable to any AI agent with skill support, and developers can point AI agents to the skills directory for structured task handling. +Skills are designed to improve AI agent performance by providing structured instructions and resources for specific tasks. Skills are best used in conjunction with tools that support skill use, though agents can be manually directed to use the skills as well. -### Skills Directory +### Setting up Skills -Skills are located in the `.github/skills/` directory. You can point AI agents to this directory to leverage the structured instructions and resources provided by the skills. +Skills are located in the `.github/skills/` directory. Many tools and agents require different directory structures to enable skill use. It is suggested to set up symlinks for the specific directory structure required. + +For example, if configuring opencode: +``` +mkdir .opencode && cd .opencode/ && ln -s ../.github/skills skills +``` ### List of Skills @@ -39,7 +44,7 @@ If you find yourself performing similar structured tasks with an AI agent, consi ### Using Skills -Skills relevant to particular tasks should be invoked automatically by AI agents. You may opt to directly point the agent to a skill. +Skills relevant to particular tasks should be invoked automatically by AI agents. ### Useful Links - [Skill.sh skill repository](https://skills.sh/) From 3e4c3e53f39f8862b8e4474ccd4fb7cdc3ba5036 Mon Sep 17 00:00:00 2001 From: Harjun751 Date: Tue, 3 Feb 2026 11:17:52 +0800 Subject: [PATCH 3/4] Update skill set up instruction --- docs/devGuide/development/aiUse.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/devGuide/development/aiUse.md b/docs/devGuide/development/aiUse.md index dbfc2862c7..7034350e0f 100644 --- a/docs/devGuide/development/aiUse.md +++ b/docs/devGuide/development/aiUse.md @@ -23,7 +23,7 @@ Skills are located in the `.github/skills/` directory. Many tools and agents req For example, if configuring opencode: ``` -mkdir .opencode && cd .opencode/ && ln -s ../.github/skills skills +ln -s .github/ .opencode ``` ### List of Skills From ce3b3a10b745fde9d3e19275929501fbe6eaf12e Mon Sep 17 00:00:00 2001 From: Harjun751 Date: Tue, 3 Feb 2026 20:51:47 +0800 Subject: [PATCH 4/4] Add warning on skill use in dev docs --- docs/devGuide/development/aiUse.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/devGuide/development/aiUse.md b/docs/devGuide/development/aiUse.md index 7034350e0f..2627b8e50b 100644 --- a/docs/devGuide/development/aiUse.md +++ b/docs/devGuide/development/aiUse.md @@ -17,6 +17,8 @@ The MarkBind project has configurations that facilitate AI use. Skills are designed to improve AI agent performance by providing structured instructions and resources for specific tasks. Skills are best used in conjunction with tools that support skill use, though agents can be manually directed to use the skills as well. +Do not use Skills found online without auditing them first. It is also strongly recommended to create a separate pull request to review the Skill before proper use. + ### Setting up Skills Skills are located in the `.github/skills/` directory. Many tools and agents require different directory structures to enable skill use. It is suggested to set up symlinks for the specific directory structure required.