Agent Skills

SKILL.md வரையறைகள் மூலம் மீண்டும் பயன்படுத்தக்கூடிய நடத்தையை வரையறுக்கவும்

Agent skills Dropstone-ஐ உங்கள் repo அல்லது home directory-ல் இருந்து மீண்டும் பயன்படுத்தக்கூடிய வழிமுறைகளைக் கண்டறிய அனுமதிக்கிறது. Skills உள்ளமைக்கப்பட்ட skill tool மூலம் on-demand-ல் ஏற்றப்படுகின்றன: agents எந்த skills கிடைக்கின்றன என்பதைக் காணலாம் மற்றும் ஒன்று பணியுடன் பொருந்தும் போது முழு உள்ளடக்கத்தை ஏற்றலாம்.

Place files

ஒவ்வொரு skill பெயருக்கும் ஒரு folder உருவாக்கி அதற்குள் SKILL.md வைக்கவும். Dropstone இந்த இடங்களைத் தேடுகிறது:

Project config: .dropstone/skills/<name>/SKILL.md
Global config: ~/.config/dropstone/skills/<name>/SKILL.md
Project Claude-compatible: .claude/skills/<name>/SKILL.md
Global Claude-compatible: ~/.claude/skills/<name>/SKILL.md
Project agent-compatible: .agents/skills/<name>/SKILL.md
Global agent-compatible: ~/.agents/skills/<name>/SKILL.md

Understand discovery

Project-local paths-க்கு, Dropstone உங்கள் தற்போதைய working directory-ல் இருந்து git worktree-ஐ அடையும் வரை மேலே நடக்கிறது. .dropstone/-ல் எந்த பொருந்தும் skills/*/SKILL.md மற்றும் வழியில் எந்த பொருந்தும் .claude/skills/*/SKILL.md அல்லது .agents/skills/*/SKILL.md ஐ ஏற்றுகிறது.

Global வரையறைகள் ~/.config/dropstone/skills/*/SKILL.md, ~/.claude/skills/*/SKILL.md, மற்றும் ~/.agents/skills/*/SKILL.md-ல் இருந்தும் ஏற்றப்படுகின்றன.

Write frontmatter

ஒவ்வொரு SKILL.md-ம் YAML frontmatter-ஆல் தொடங்க வேண்டும். இந்த fields மட்டுமே அங்கீகரிக்கப்படுகின்றன:

name (required)
description (required)
license (optional)
compatibility (optional)
metadata (optional, string-to-string map)

அறியப்படாத frontmatter fields புறக்கணிக்கப்படுகின்றன.

Validate names

name பின்வருவனவற்றை செய்ய வேண்டும்:

1–64 characters ஆக இருக்க வேண்டும்
lowercase alphanumeric ஆக இருக்க வேண்டும் single hyphen separators-உடன்
- ஆல் தொடங்க அல்லது முடிக்க வேண்டாம்
consecutive -- கொண்டிருக்க வேண்டாம்
SKILL.md கொண்டிருக்கும் directory பெயருடன் பொருந்த வேண்டும்

Equivalent regex:

^[a-z0-9]+(-[a-z0-9]+)*$

Follow length rules

description 1-1024 characters ஆக இருக்க வேண்டும். agent சரியாக தேர்வு செய்ய போதுமான specificity-ஐ வைத்திருக்கவும்.

Use an example

.dropstone/skills/git-release/SKILL.md போன்ற உருவாக்கவும்:

---
name: git-release
description: Create consistent releases and changelogs
license: MIT
compatibility: dropstone
metadata:
  audience: maintainers
  workflow: github
---

## What I do

- Draft release notes from merged PRs
- Propose a version bump
- Provide a copy-pasteable `gh release create` command

## When to use me

Use this when you are preparing a tagged release.
Ask clarifying questions if the target versioning scheme is unclear.

Recognize tool description

Dropstone skill tool description-ல் கிடைக்கும் skills-ஐ பட்டியலிடுகிறது. ஒவ்வொரு entry-ம் skill பெயர் மற்றும் description-ஐ உள்ளடக்கியுள்ளது:

<available_skills>
  <skill>
    <name>git-release</name>
    <description>Create consistent releases and changelogs</description>
  </skill>
</available_skills>

Agent tool-ஐ அழைப்பதன் மூலம் skill-ஐ ஏற்றுகிறது:

skill({ name: "git-release" })

Configure permissions

dropstone.json-ல் pattern-based permissions-ஐ பயன்படுத்தி agents எந்த skills-ஐ அணுக முடியும் என்பதைக் கட்டுப்படுத்தவும்:

{
  "permission": {
    "skill": {
      "*": "allow",
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

Permission	Behavior
`allow`	Skill loads immediately
`deny`	Skill hidden from agent, access rejected
`ask`	User prompted for approval before loading

Patterns wildcards-ஐ support செய்கின்றன: internal-* internal-docs, internal-tools, முதலியவற்றுடன் பொருந்துகிறது.

Override per agent

Global defaults-ஐ விட specific agents-க்கு வெவ்வேறு permissions-ஐ கொடுக்கவும்.

Custom agents-க்கு (agent frontmatter-ல்):

---
permission:
  skill:
    "documents-*": "allow"
---

Built-in agents-க்கு (dropstone.json-ல்):

{
  "agent": {
    "plan": {
      "permission": {
        "skill": {
          "internal-*": "allow"
        }
      }
    }
  }
}

Disable the skill tool

Agents-க்கு skills-ஐ பயன்படுத்த வேண்டாம் என்பதற்கு skill tool-ஐ முற்றிலுமாக முடக்கவும்:

Custom agents-க்கு:

---
tools:
  skill: false
---

Built-in agents-க்கு:

{
  "agent": {
    "plan": {
      "tools": {
        "skill": false
      }
    }
  }
}

முடக்கப்பட்டபோது, <available_skills> section முற்றிலுமாக தவிர்க்கப்படுகிறது.

Troubleshoot loading

Skill தோன்றாவிட்டால்:

SKILL.md அனைத்து caps-ல் spelled என்பதை சரிபார்க்கவும்
Frontmatter name மற்றும் description-ஐ உள்ளடக்கியுள்ளது என்பதை சரிபார்க்கவும்
Skill names அனைத்து locations-ல் unique என்பதை உறுதிசெய்யவும்
Permissions-ஐ சரிபார்க்கவும்: deny உடைய skills agents-ல் இருந்து மறைக்கப்பட்டுள்ளன

Permissions

Plugins