⚠️ Mandatory Rules (AI must comply)
Rule 1: Ambiguous words must be asked about
When the user input contains the followingambiguous words,it is forbidden to directly execute any operation, and you must first ask for confirmation:
| Ambiguous word | Must ask |
|---|---|
| "display" | ✅ Must ask |
| "show" | ✅ Must ask |
Correct process:
用户: "显示所有技能"
AI: "'显示'有两种含义:
[1] 恢复(取消隐藏)技能
[2] 查看/列出技能列表
请回复 1 或 2:"
Incorrect behavior (forbidden):
- ❌ Directly list skills
- ❌ Directly restore skills
- ❌ Assume the user's intent
Rule 2: Non-ambiguous words are executed directly
| User input | Intent | Execute directly |
|---|---|---|
| "hide xxx" | Hide skill | hide_skill.py xxx |
| "view/list xxx" | Preview skill | --show-all |
| "restore xxx" / "unhide xxx" | Restore skill | unhide_skill.py xxx |
| "which ones are hidden" | View hidden list | list_hidden.py |
Terminology
| Term | Meaning | Corresponding operation |
|---|---|---|
| Hide | Mark the skill as hidden | hide_skill.py |
| Restore | Unhide, making the skill visible again | unhide_skill.py |
| Preview/view/list | Only view the skill list, without modifying | --show-all |
Prerequisites
- Dependencies: Python standard library, no additional dependencies required
Configuration Management
First-time use requires configuring the skill parent folder path.
Configuration Method
Path format description: use forward slashes
/compatible with Windows CMD, PowerShell, and Unix-like shells (Git Bash, MSYS2, WSL)
# 添加单个路径
python skill-hide/scripts/config_manager.py --add "C:/path/to/skills"
# 添加多个路径
python skill-hide/scripts/config_manager.py --add "C:/path1" --add "D:/path2"
# 覆盖设置所有路径(逗号分隔)
python skill-hide/scripts/config_manager.py --set "C:/path1,D:/path2,E:/path3"
# 列出当前配置
python skill-hide/scripts/config_manager.py --list
# 清空所有配置
python skill-hide/scripts/config_manager.py --clear
# 不带参数运行,显示当前配置和参考路径
python skill-hide/scripts/config_manager.py
Operation Steps
Hide Skill
# 隐藏单个
python skill-hide/scripts/hide_skill.py <skill-name>
# 隐藏多个
python skill-hide/scripts/hide_skill.py <skill1> <skill2>
# 隐藏所有(所有配置文件夹)
python skill-hide/scripts/hide_skill.py --all
# 隐藏指定文件夹下的所有技能
python skill-hide/scripts/hide_skill.py --all --folder <path>
# 指定文件夹
python skill-hide/scripts/hide_skill.py <skill-name> --folder <path>
Restore Skill
# 恢复单个
python skill-hide/scripts/unhide_skill.py <skill-name>
# 恢复多个
python skill-hide/scripts/unhide_skill.py <skill1> <skill2>
# 恢复所有(所有配置文件夹)
python skill-hide/scripts/unhide_skill.py --all
# 恢复指定文件夹下的所有技能
python skill-hide/scripts/unhide_skill.py --all --folder <path>
# 指定文件夹
python skill-hide/scripts/unhide_skill.py <skill-name> --folder <path>
Preview Skill (view only, no modification)
# 查看所有配置文件夹的技能状态(多文件夹场景)
python skill-hide/scripts/hide_skill.py --show-all
# 查看指定文件夹的技能状态
python skill-hide/scripts/hide_skill.py --show-all --folder <path>
# 查看所有已隐藏的技能(跨所有配置文件夹)
python skill-hide/scripts/list_hidden.py
# 查看操作历史记录
python skill-hide/scripts/list_history.py
# 查看操作过的文件夹列表
python skill-hide/scripts/list_history.py --folders
Resource Index
scripts/config_manager.py- Read/write configurationscripts/hide_skill.py- Hide skills / view all skill statuses (supports multiple folders)scripts/unhide_skill.py- Restore skillsscripts/list_hidden.py- List all hidden skills (across folders)scripts/list_history.py- View operation history
Notes
- Forbidden to hide itself: skill-hide cannot hide itself
- Path normalization: automatically unify to use forward slashes
/ - Multi-directory support:
- Multiple skill parent folder paths can be saved in the configuration file
- When hiding/restoring skills, all configured folders will be searched
--show-allWhen not specifying--folder, the status of all configured folders will be displayed
- Skills with the same name: Skills with the same name can exist in different folders; when hiding/restoring, all matching skills will be operated on
- Configuration file:
skill-hide/.skill-config.json
⚠️ Important: AI Usage Guide
How to determine whether a skill is hidden
Do not rely solely on tool output, you must verify through the file system:
# 正确:直接检查文件存在性
ls -la skill-folder/
# 显示状态: SKILL.md 存在
# 隐藏状态: SKILL.md.hide 存在, SKILL.md 不存在
Determination logic:
| File existence status | Status |
|---|---|
SKILL.md exists |
✅ Visible |
SKILL.md.hide exists, and SKILL.md does not exist |
❌ Hidden |
Known issues
- Windows console encoding issue: script output in Chinese may appear garbled (does not affect actual functionality)
- Verification mechanism: after all hide/restore operations, the file status should be verified to ensure the operation succeeded
Quick reference table
| User input | Ambiguous? | AI action |
|---|---|---|
| "hide xxx" | ❌ | Execute hide directly |
| "view/list xxx" | ❌ | Execute preview directly |
| "restore/unhide xxx" | ❌ | Execute restore directly |
| "show xxx" | ✅ | Must ask |
| "display xxx" | ✅ | Must ask |
| "which ones are hidden" | ❌ | Execute list_hidden.py directly |