[{"data":1,"prerenderedAt":1763},["Reactive",2],{"/posts/claude-code-skills":3,"/posts/claude-code-skills:related":1662,"/posts/claude-code-skills:alternate":1762},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"read":11,"body":12,"_type":941,"_id":1657,"_source":1658,"_file":1659,"_extension":1660,"sitemap":1661},"/posts/claude-code-skills","posts",false,"","Claude Code skills: what they are and how to write one","Claude Code skills explained: SKILL.md and its frontmatter, where skills live, how they trigger, and how to write one step by step, with a real example.","2026-11-21","10 min",{"type":13,"children":14,"toc":1633},"root",[15,51,74,81,95,115,142,147,153,158,160,312,317,338,344,364,369,371,473,492,497,503,530,542,544,770,797,865,871,876,883,895,906,912,917,923,936,947,967,1011,1017,1029,1039,1067,1073,1086,1140,1152,1158,1175,1186,1243,1295,1309,1318,1353,1359,1373,1386,1395,1406,1443,1449,1463,1518,1531,1537,1543,1572,1578,1590,1596,1615,1621],{"type":16,"tag":17,"props":18,"children":19},"element","p",{},[20,23,30,32,38,40,49],{"type":21,"value":22},"text","A Claude Code skill is a folder with a ",{"type":16,"tag":24,"props":25,"children":27},"code",{"className":26},[],[28],{"type":21,"value":29},"SKILL.md",{"type":21,"value":31}," file in it. The file holds instructions, and Claude Code either loads them when your request matches the skill's description or runs them when you type ",{"type":16,"tag":24,"props":33,"children":35},{"className":34},[],[36],{"type":21,"value":37},"/skill-name",{"type":21,"value":39},". I maintain an open-source skill, ",{"type":16,"tag":41,"props":42,"children":46},"a",{"href":43,"rel":44},"https://halitsever.github.io/explain-to-customer/",[45],"noopener",[47],{"type":21,"value":48},"explain-to-customer",{"type":21,"value":50},", and use it as the real example here. The post covers how Claude Code skills are found and triggered, which frontmatter fields matter, and when to package one in a plugin.",{"type":16,"tag":17,"props":52,"children":53},{},[54,56,63,65,72],{"type":21,"value":55},"Everything below is checked against Anthropic's ",{"type":16,"tag":41,"props":57,"children":60},{"href":58,"rel":59},"https://code.claude.com/docs/en/skills",[45],[61],{"type":21,"value":62},"skills documentation",{"type":21,"value":64}," and the ",{"type":16,"tag":41,"props":66,"children":69},{"href":67,"rel":68},"https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview",[45],[70],{"type":21,"value":71},"Agent Skills overview",{"type":21,"value":73},". Claude Code changes quickly, so if your version differs, trust the docs.",{"type":16,"tag":75,"props":76,"children":78},"h2",{"id":77},"what-are-claude-code-skills",[79],{"type":21,"value":80},"What are Claude Code skills?",{"type":16,"tag":17,"props":82,"children":83},{},[84,86,93],{"type":21,"value":85},"A skill is a reusable set of instructions, optionally with reference docs, templates or scripts next to it. Claude Code skills follow the ",{"type":16,"tag":41,"props":87,"children":90},{"href":88,"rel":89},"https://agentskills.io",[45],[91],{"type":21,"value":92},"Agent Skills",{"type":21,"value":94}," open standard, and Claude Code adds its own features on top, such as invocation control and running a skill in a subagent.",{"type":16,"tag":17,"props":96,"children":97},{},[98,100,106,108,113],{"type":21,"value":99},"The docs suggest making one when you keep pasting the same instructions into chat, or when a section of ",{"type":16,"tag":24,"props":101,"children":103},{"className":102},[],[104],{"type":21,"value":105},"CLAUDE.md",{"type":21,"value":107}," has turned into a procedure rather than a fact. The reason is context. ",{"type":16,"tag":24,"props":109,"children":111},{"className":110},[],[112],{"type":21,"value":105},{"type":21,"value":114}," is loaded into every session, while a skill loads in stages:",{"type":16,"tag":116,"props":117,"children":118},"ol",{},[119,125,137],{"type":16,"tag":120,"props":121,"children":122},"li",{},[123],{"type":21,"value":124},"The name and description sit in Claude's context so it knows the skill exists. Anthropic's overview puts this at about 100 tokens per skill.",{"type":16,"tag":120,"props":126,"children":127},{},[128,130,135],{"type":21,"value":129},"The body of ",{"type":16,"tag":24,"props":131,"children":133},{"className":132},[],[134],{"type":21,"value":29},{"type":21,"value":136}," enters the conversation only when the skill is invoked.",{"type":16,"tag":120,"props":138,"children":139},{},[140],{"type":21,"value":141},"Supporting files load only when Claude reads them, and scripts run without their source entering the context at all. Only their output does.",{"type":16,"tag":17,"props":143,"children":144},{},[145],{"type":21,"value":146},"So a 300-line release procedure costs almost nothing until the day you release.",{"type":16,"tag":75,"props":148,"children":150},{"id":149},"where-do-claude-code-skills-live",[151],{"type":21,"value":152},"Where do Claude Code skills live?",{"type":16,"tag":17,"props":154,"children":155},{},[156],{"type":21,"value":157},"Where you save the folder decides which sessions see it:",{"type":21,"value":159},"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",{"type":16,"tag":161,"props":162,"children":163},"table",{},[164,189],{"type":16,"tag":165,"props":166,"children":167},"thead",{},[168],{"type":16,"tag":169,"props":170,"children":171},"tr",{},[172,179,184],{"type":16,"tag":173,"props":174,"children":176},"th",{"align":175},"left",[177],{"type":21,"value":178},"Location",{"type":16,"tag":173,"props":180,"children":181},{"align":175},[182],{"type":21,"value":183},"Path",{"type":16,"tag":173,"props":185,"children":186},{"align":175},[187],{"type":21,"value":188},"Available in",{"type":16,"tag":190,"props":191,"children":192},"tbody",{},[193,216,238,260,288],{"type":16,"tag":169,"props":194,"children":195},{},[196,202,211],{"type":16,"tag":197,"props":198,"children":199},"td",{"align":175},[200],{"type":21,"value":201},"Personal",{"type":16,"tag":197,"props":203,"children":204},{"align":175},[205],{"type":16,"tag":24,"props":206,"children":208},{"className":207},[],[209],{"type":21,"value":210},"~/.claude/skills/\u003Cname>/SKILL.md",{"type":16,"tag":197,"props":212,"children":213},{"align":175},[214],{"type":21,"value":215},"All your projects on this machine",{"type":16,"tag":169,"props":217,"children":218},{},[219,224,233],{"type":16,"tag":197,"props":220,"children":221},{"align":175},[222],{"type":21,"value":223},"Project",{"type":16,"tag":197,"props":225,"children":226},{"align":175},[227],{"type":16,"tag":24,"props":228,"children":230},{"className":229},[],[231],{"type":21,"value":232},".claude/skills/\u003Cname>/SKILL.md",{"type":16,"tag":197,"props":234,"children":235},{"align":175},[236],{"type":21,"value":237},"This repository. Commit it and your team gets it",{"type":16,"tag":169,"props":239,"children":240},{},[241,246,255],{"type":16,"tag":197,"props":242,"children":243},{"align":175},[244],{"type":21,"value":245},"Nested",{"type":16,"tag":197,"props":247,"children":248},{"align":175},[249],{"type":16,"tag":24,"props":250,"children":252},{"className":251},[],[253],{"type":21,"value":254},"\u003Csubdir>/.claude/skills/\u003Cname>/SKILL.md",{"type":16,"tag":197,"props":256,"children":257},{"align":175},[258],{"type":21,"value":259},"Sessions started in that subdirectory, or once Claude works on files there",{"type":16,"tag":169,"props":261,"children":262},{},[263,268,277],{"type":16,"tag":197,"props":264,"children":265},{"align":175},[266],{"type":21,"value":267},"Plugin",{"type":16,"tag":197,"props":269,"children":270},{"align":175},[271],{"type":16,"tag":24,"props":272,"children":274},{"className":273},[],[275],{"type":21,"value":276},"\u003Cplugin>/skills/\u003Cname>/SKILL.md",{"type":16,"tag":197,"props":278,"children":279},{"align":175},[280,282],{"type":21,"value":281},"Wherever the plugin is enabled, as ",{"type":16,"tag":24,"props":283,"children":285},{"className":284},[],[286],{"type":21,"value":287},"/plugin-name:skill-name",{"type":16,"tag":169,"props":289,"children":290},{},[291,296,307],{"type":16,"tag":197,"props":292,"children":293},{"align":175},[294],{"type":21,"value":295},"Enterprise",{"type":16,"tag":197,"props":297,"children":298},{"align":175},[299,305],{"type":16,"tag":24,"props":300,"children":302},{"className":301},[],[303],{"type":21,"value":304},".claude/skills/",{"type":21,"value":306}," in the managed settings directory",{"type":16,"tag":197,"props":308,"children":309},{"align":175},[310],{"type":21,"value":311},"Everyone on machines where the organization deploys it",{"type":16,"tag":17,"props":313,"children":314},{},[315],{"type":21,"value":316},"If the same name exists in more than one place, enterprise beats personal and personal beats project. Plugin skills never clash because they are namespaced. A skill folder can also be a symlink.",{"type":16,"tag":17,"props":318,"children":319},{},[320,322,328,330,336],{"type":21,"value":321},"Claude Code watches these directories, so a new or edited skill takes effect in the running session. If a new one doesn't show up, run ",{"type":16,"tag":24,"props":323,"children":325},{"className":324},[],[326],{"type":21,"value":327},"/reload-skills",{"type":21,"value":329},". Cloud sessions and Cowork don't read ",{"type":16,"tag":24,"props":331,"children":333},{"className":332},[],[334],{"type":21,"value":335},"~/.claude/skills/",{"type":21,"value":337}," on your machine, so for those, commit the skill to the repository or enable it for your claude.ai account.",{"type":16,"tag":75,"props":339,"children":341},{"id":340},"how-are-skills-triggered",[342],{"type":21,"value":343},"How are skills triggered?",{"type":16,"tag":17,"props":345,"children":346},{},[347,349,354,356,362],{"type":21,"value":348},"There are two ways in. You type ",{"type":16,"tag":24,"props":350,"children":352},{"className":351},[],[353],{"type":21,"value":37},{"type":21,"value":355}," at the start of a message and Claude Code runs it directly, with anything after the name passed in as arguments. Or Claude decides on its own that your request matches the skill's ",{"type":16,"tag":24,"props":357,"children":359},{"className":358},[],[360],{"type":21,"value":361},"description",{"type":21,"value":363}," and loads it.",{"type":16,"tag":17,"props":365,"children":366},{},[367],{"type":21,"value":368},"Two frontmatter fields change who can do what:",{"type":21,"value":370},"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",{"type":16,"tag":161,"props":372,"children":373},{},[374,400],{"type":16,"tag":165,"props":375,"children":376},{},[377],{"type":16,"tag":169,"props":378,"children":379},{},[380,385,390,395],{"type":16,"tag":173,"props":381,"children":382},{"align":175},[383],{"type":21,"value":384},"Frontmatter",{"type":16,"tag":173,"props":386,"children":387},{"align":175},[388],{"type":21,"value":389},"You can invoke",{"type":16,"tag":173,"props":391,"children":392},{"align":175},[393],{"type":21,"value":394},"Claude can invoke",{"type":16,"tag":173,"props":396,"children":397},{"align":175},[398],{"type":21,"value":399},"Description in context",{"type":16,"tag":190,"props":401,"children":402},{},[403,424,449],{"type":16,"tag":169,"props":404,"children":405},{},[406,411,416,420],{"type":16,"tag":197,"props":407,"children":408},{"align":175},[409],{"type":21,"value":410},"(default)",{"type":16,"tag":197,"props":412,"children":413},{"align":175},[414],{"type":21,"value":415},"Yes",{"type":16,"tag":197,"props":417,"children":418},{"align":175},[419],{"type":21,"value":415},{"type":16,"tag":197,"props":421,"children":422},{"align":175},[423],{"type":21,"value":415},{"type":16,"tag":169,"props":425,"children":426},{},[427,436,440,445],{"type":16,"tag":197,"props":428,"children":429},{"align":175},[430],{"type":16,"tag":24,"props":431,"children":433},{"className":432},[],[434],{"type":21,"value":435},"disable-model-invocation: true",{"type":16,"tag":197,"props":437,"children":438},{"align":175},[439],{"type":21,"value":415},{"type":16,"tag":197,"props":441,"children":442},{"align":175},[443],{"type":21,"value":444},"No",{"type":16,"tag":197,"props":446,"children":447},{"align":175},[448],{"type":21,"value":444},{"type":16,"tag":169,"props":450,"children":451},{},[452,461,465,469],{"type":16,"tag":197,"props":453,"children":454},{"align":175},[455],{"type":16,"tag":24,"props":456,"children":458},{"className":457},[],[459],{"type":21,"value":460},"user-invocable: false",{"type":16,"tag":197,"props":462,"children":463},{"align":175},[464],{"type":21,"value":444},{"type":16,"tag":197,"props":466,"children":467},{"align":175},[468],{"type":21,"value":415},{"type":16,"tag":197,"props":470,"children":471},{"align":175},[472],{"type":21,"value":415},{"type":16,"tag":17,"props":474,"children":475},{},[476,478,483,485,490],{"type":21,"value":477},"Use ",{"type":16,"tag":24,"props":479,"children":481},{"className":480},[],[482],{"type":21,"value":435},{"type":21,"value":484}," for anything with side effects, like deploying or committing. You don't want Claude deciding to deploy because the code looks ready. Use ",{"type":16,"tag":24,"props":486,"children":488},{"className":487},[],[489],{"type":21,"value":460},{"type":21,"value":491}," for background knowledge, like how a legacy system works.",{"type":16,"tag":17,"props":493,"children":494},{},[495],{"type":21,"value":496},"Once a skill is invoked, its rendered content stays in the conversation for the rest of the session. Claude Code doesn't re-read the file on later turns. After auto-compaction it re-attaches the first 5,000 tokens of each invoked skill, so put the instructions that matter most at the top.",{"type":16,"tag":75,"props":498,"children":500},{"id":499},"the-skillmd-format-and-frontmatter",[501],{"type":21,"value":502},"The SKILL.md format and frontmatter",{"type":16,"tag":17,"props":504,"children":505},{},[506,508,513,515,521,523,528],{"type":21,"value":507},"A ",{"type":16,"tag":24,"props":509,"children":511},{"className":510},[],[512],{"type":21,"value":29},{"type":21,"value":514}," has two parts: YAML frontmatter between ",{"type":16,"tag":24,"props":516,"children":518},{"className":517},[],[519],{"type":21,"value":520},"---",{"type":21,"value":522}," markers, and Markdown instructions after it. The opening ",{"type":16,"tag":24,"props":524,"children":526},{"className":525},[],[527],{"type":21,"value":520},{"type":21,"value":529}," has to be the first line of the file, or Claude Code treats the whole thing as plain content.",{"type":16,"tag":17,"props":531,"children":532},{},[533,535,540],{"type":21,"value":534},"Every field is optional. Only ",{"type":16,"tag":24,"props":536,"children":538},{"className":537},[],[539],{"type":21,"value":361},{"type":21,"value":541}," is recommended, because it is what Claude matches your request against. The common fields:",{"type":21,"value":543},"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",{"type":16,"tag":161,"props":545,"children":546},{},[547,563],{"type":16,"tag":165,"props":548,"children":549},{},[550],{"type":16,"tag":169,"props":551,"children":552},{},[553,558],{"type":16,"tag":173,"props":554,"children":555},{"align":175},[556],{"type":21,"value":557},"Field",{"type":16,"tag":173,"props":559,"children":560},{"align":175},[561],{"type":21,"value":562},"What it does",{"type":16,"tag":190,"props":564,"children":565},{},[566,583,599,616,639,656,681,698,723,753],{"type":16,"tag":169,"props":567,"children":568},{},[569,578],{"type":16,"tag":197,"props":570,"children":571},{"align":175},[572],{"type":16,"tag":24,"props":573,"children":575},{"className":574},[],[576],{"type":21,"value":577},"name",{"type":16,"tag":197,"props":579,"children":580},{"align":175},[581],{"type":21,"value":582},"The command name. Defaults to the folder name",{"type":16,"tag":169,"props":584,"children":585},{},[586,594],{"type":16,"tag":197,"props":587,"children":588},{"align":175},[589],{"type":16,"tag":24,"props":590,"children":592},{"className":591},[],[593],{"type":21,"value":361},{"type":16,"tag":197,"props":595,"children":596},{"align":175},[597],{"type":21,"value":598},"What the skill does and when to use it",{"type":16,"tag":169,"props":600,"children":601},{},[602,611],{"type":16,"tag":197,"props":603,"children":604},{"align":175},[605],{"type":16,"tag":24,"props":606,"children":608},{"className":607},[],[609],{"type":21,"value":610},"when_to_use",{"type":16,"tag":197,"props":612,"children":613},{"align":175},[614],{"type":21,"value":615},"Extra trigger phrases, appended to the description",{"type":16,"tag":169,"props":617,"children":618},{},[619,628],{"type":16,"tag":197,"props":620,"children":621},{"align":175},[622],{"type":16,"tag":24,"props":623,"children":625},{"className":624},[],[626],{"type":21,"value":627},"argument-hint",{"type":16,"tag":197,"props":629,"children":630},{"align":175},[631,633],{"type":21,"value":632},"Shown in autocomplete, for example ",{"type":16,"tag":24,"props":634,"children":636},{"className":635},[],[637],{"type":21,"value":638},"[issue-number]",{"type":16,"tag":169,"props":640,"children":641},{},[642,651],{"type":16,"tag":197,"props":643,"children":644},{"align":175},[645],{"type":16,"tag":24,"props":646,"children":648},{"className":647},[],[649],{"type":21,"value":650},"disable-model-invocation",{"type":16,"tag":197,"props":652,"children":653},{"align":175},[654],{"type":21,"value":655},"Only you can start it",{"type":16,"tag":169,"props":657,"children":658},{},[659,668],{"type":16,"tag":197,"props":660,"children":661},{"align":175},[662],{"type":16,"tag":24,"props":663,"children":665},{"className":664},[],[666],{"type":21,"value":667},"user-invocable",{"type":16,"tag":197,"props":669,"children":670},{"align":175},[671,673,679],{"type":21,"value":672},"Set to ",{"type":16,"tag":24,"props":674,"children":676},{"className":675},[],[677],{"type":21,"value":678},"false",{"type":21,"value":680}," so only Claude can start it",{"type":16,"tag":169,"props":682,"children":683},{},[684,693],{"type":16,"tag":197,"props":685,"children":686},{"align":175},[687],{"type":16,"tag":24,"props":688,"children":690},{"className":689},[],[691],{"type":21,"value":692},"allowed-tools",{"type":16,"tag":197,"props":694,"children":695},{"align":175},[696],{"type":21,"value":697},"Tools Claude can use without asking during the turn that invokes the skill",{"type":16,"tag":169,"props":699,"children":700},{},[701,718],{"type":16,"tag":197,"props":702,"children":703},{"align":175},[704,710,712],{"type":16,"tag":24,"props":705,"children":707},{"className":706},[],[708],{"type":21,"value":709},"model",{"type":21,"value":711},", ",{"type":16,"tag":24,"props":713,"children":715},{"className":714},[],[716],{"type":21,"value":717},"effort",{"type":16,"tag":197,"props":719,"children":720},{"align":175},[721],{"type":21,"value":722},"Override the model or effort level for that turn",{"type":16,"tag":169,"props":724,"children":725},{},[726,742],{"type":16,"tag":197,"props":727,"children":728},{"align":175},[729,735,736],{"type":16,"tag":24,"props":730,"children":732},{"className":731},[],[733],{"type":21,"value":734},"context",{"type":21,"value":711},{"type":16,"tag":24,"props":737,"children":739},{"className":738},[],[740],{"type":21,"value":741},"agent",{"type":16,"tag":197,"props":743,"children":744},{"align":175},[745,751],{"type":16,"tag":24,"props":746,"children":748},{"className":747},[],[749],{"type":21,"value":750},"context: fork",{"type":21,"value":752}," runs the skill in a subagent of the given type",{"type":16,"tag":169,"props":754,"children":755},{},[756,765],{"type":16,"tag":197,"props":757,"children":758},{"align":175},[759],{"type":16,"tag":24,"props":760,"children":762},{"className":761},[],[763],{"type":21,"value":764},"paths",{"type":16,"tag":197,"props":766,"children":767},{"align":175},[768],{"type":21,"value":769},"Globs that limit when the skill activates",{"type":16,"tag":17,"props":771,"children":772},{},[773,775,781,783,788,790,795],{"type":21,"value":774},"Claude Code silently ignores a field name it doesn't recognize, so a typo like ",{"type":16,"tag":24,"props":776,"children":778},{"className":777},[],[779],{"type":21,"value":780},"disable-model-invocations",{"type":21,"value":782}," does nothing and reports nothing. The combined ",{"type":16,"tag":24,"props":784,"children":786},{"className":785},[],[787],{"type":21,"value":361},{"type":21,"value":789}," and ",{"type":16,"tag":24,"props":791,"children":793},{"className":792},[],[794],{"type":21,"value":610},{"type":21,"value":796}," text is cut at 1,536 characters in the skill listing, so lead with the main use case.",{"type":16,"tag":17,"props":798,"children":799},{},[800,802,807,808,813,814,820,821,827,828,834,835,840,842,847,849,855,857,863],{"type":21,"value":801},"If you also want the skill to work on claude.ai or through the Skills API, stick to the six fields the open spec allows: ",{"type":16,"tag":24,"props":803,"children":805},{"className":804},[],[806],{"type":21,"value":577},{"type":21,"value":711},{"type":16,"tag":24,"props":809,"children":811},{"className":810},[],[812],{"type":21,"value":361},{"type":21,"value":711},{"type":16,"tag":24,"props":815,"children":817},{"className":816},[],[818],{"type":21,"value":819},"license",{"type":21,"value":711},{"type":16,"tag":24,"props":822,"children":824},{"className":823},[],[825],{"type":21,"value":826},"compatibility",{"type":21,"value":711},{"type":16,"tag":24,"props":829,"children":831},{"className":830},[],[832],{"type":21,"value":833},"metadata",{"type":21,"value":789},{"type":16,"tag":24,"props":836,"children":838},{"className":837},[],[839],{"type":21,"value":692},{"type":21,"value":841},". Uploads with any other field fail. The overview also sets stricter rules for ",{"type":16,"tag":24,"props":843,"children":845},{"className":844},[],[846],{"type":21,"value":577},{"type":21,"value":848}," there: at most 64 characters, lowercase letters, numbers and hyphens only, and no ",{"type":16,"tag":24,"props":850,"children":852},{"className":851},[],[853],{"type":21,"value":854},"anthropic",{"type":21,"value":856}," or ",{"type":16,"tag":24,"props":858,"children":860},{"className":859},[],[861],{"type":21,"value":862},"claude",{"type":21,"value":864}," in it.",{"type":16,"tag":75,"props":866,"children":868},{"id":867},"how-to-write-a-claude-code-skill-step-by-step",[869],{"type":21,"value":870},"How to write a Claude Code skill, step by step",{"type":16,"tag":17,"props":872,"children":873},{},[874],{"type":21,"value":875},"This example makes a skill that drafts a pull request description from the current branch.",{"type":16,"tag":877,"props":878,"children":880},"h3",{"id":879},"_1-create-the-folder",[881],{"type":21,"value":882},"1. Create the folder",{"type":16,"tag":884,"props":885,"children":890},"pre",{"className":886,"code":888,"language":889,"meta":7},[887],"language-bash","mkdir -p .claude/skills/pr-description\n","bash",[891],{"type":16,"tag":24,"props":892,"children":893},{"__ignoreMap":7},[894],{"type":21,"value":888},{"type":16,"tag":17,"props":896,"children":897},{},[898,899,904],{"type":21,"value":477},{"type":16,"tag":24,"props":900,"children":902},{"className":901},[],[903],{"type":21,"value":335},{"type":21,"value":905}," instead if you want it in every project.",{"type":16,"tag":877,"props":907,"children":909},{"id":908},"_2-write-the-description-first",[910],{"type":21,"value":911},"2. Write the description first",{"type":16,"tag":17,"props":913,"children":914},{},[915],{"type":21,"value":916},"The description decides whether Claude ever uses the skill. Say what it does and when to use it, in the third person. Anthropic's authoring guide notes that the description is injected into the system prompt, and a mixed point of view can hurt discovery.",{"type":16,"tag":877,"props":918,"children":920},{"id":919},"_3-write-the-body",[921],{"type":21,"value":922},"3. Write the body",{"type":16,"tag":17,"props":924,"children":925},{},[926,928,934],{"type":21,"value":927},"Save this as ",{"type":16,"tag":24,"props":929,"children":931},{"className":930},[],[932],{"type":21,"value":933},".claude/skills/pr-description/SKILL.md",{"type":21,"value":935},":",{"type":16,"tag":884,"props":937,"children":942},{"className":938,"code":940,"language":941,"meta":7},[939],"language-markdown","---\ndescription: Drafts a pull request title and description from the commits on the current branch. Use when the user asks for a PR description, PR body or PR summary.\nallowed-tools: Bash(git log *) Bash(git diff *)\n---\n\n## Commits on this branch\n\n!`git log --oneline main..HEAD`\n\n## Changed files\n\n!`git diff --stat main...HEAD`\n\n## Instructions\n\nWrite a PR title under 70 characters and a description with a short summary,\na list of user-facing changes and a testing section. Do not invent changes\nthat are not in the commits above.\n","markdown",[943],{"type":16,"tag":24,"props":944,"children":945},{"__ignoreMap":7},[946],{"type":21,"value":940},{"type":16,"tag":17,"props":948,"children":949},{},[950,952,958,960,965],{"type":21,"value":951},"The ",{"type":16,"tag":24,"props":953,"children":955},{"className":954},[],[956],{"type":21,"value":957},"!`command`",{"type":21,"value":959}," lines are dynamic context injection: Claude Code runs the command before Claude sees the skill and replaces the line with its output, so the instructions arrive with the real commits already inlined. Injected commands never show a permission prompt. Outside auto mode, a command your permission rules don't allow aborts the whole invocation, which is why the example lists both git commands in ",{"type":16,"tag":24,"props":961,"children":963},{"className":962},[],[964],{"type":21,"value":692},{"type":21,"value":966},".",{"type":16,"tag":17,"props":968,"children":969},{},[970,972,978,980,986,987,993,995,1001,1003,1009],{"type":21,"value":971},"For arguments, put ",{"type":16,"tag":24,"props":973,"children":975},{"className":974},[],[976],{"type":21,"value":977},"$ARGUMENTS",{"type":21,"value":979}," in the body and it is replaced with whatever you type after the command. ",{"type":16,"tag":24,"props":981,"children":983},{"className":982},[],[984],{"type":21,"value":985},"$0",{"type":21,"value":711},{"type":16,"tag":24,"props":988,"children":990},{"className":989},[],[991],{"type":21,"value":992},"$1",{"type":21,"value":994}," and so on pick single arguments. This body has no placeholder, so if you type ",{"type":16,"tag":24,"props":996,"children":998},{"className":997},[],[999],{"type":21,"value":1000},"/pr-description mention the migration",{"type":21,"value":1002},", Claude Code appends ",{"type":16,"tag":24,"props":1004,"children":1006},{"className":1005},[],[1007],{"type":21,"value":1008},"ARGUMENTS: mention the migration",{"type":21,"value":1010}," to the end of the content instead.",{"type":16,"tag":877,"props":1012,"children":1014},{"id":1013},"_4-add-supporting-files-when-the-body-grows",[1015],{"type":21,"value":1016},"4. Add supporting files when the body grows",{"type":16,"tag":17,"props":1018,"children":1019},{},[1020,1022,1027],{"type":21,"value":1021},"The docs suggest keeping ",{"type":16,"tag":24,"props":1023,"children":1025},{"className":1024},[],[1026],{"type":21,"value":29},{"type":21,"value":1028}," under 500 lines and moving long material into separate files that you link from it:",{"type":16,"tag":884,"props":1030,"children":1034},{"className":1031,"code":1033,"language":21,"meta":7},[1032],"language-text","pr-description/\n├── SKILL.md\n├── reference.md\n└── scripts/\n    └── check-title.sh\n",[1035],{"type":16,"tag":24,"props":1036,"children":1037},{"__ignoreMap":7},[1038],{"type":21,"value":1033},{"type":16,"tag":17,"props":1040,"children":1041},{},[1042,1044,1050,1052,1057,1059,1065],{"type":21,"value":1043},"To run a bundled script, refer to it through ",{"type":16,"tag":24,"props":1045,"children":1047},{"className":1046},[],[1048],{"type":21,"value":1049},"${CLAUDE_SKILL_DIR}",{"type":21,"value":1051},", which expands to the skill's folder wherever it is installed. Use the same variable in ",{"type":16,"tag":24,"props":1053,"children":1055},{"className":1054},[],[1056],{"type":21,"value":692},{"type":21,"value":1058},", for example ",{"type":16,"tag":24,"props":1060,"children":1062},{"className":1061},[],[1063],{"type":21,"value":1064},"Bash(${CLAUDE_SKILL_DIR}/scripts/check-title.sh *)",{"type":21,"value":1066},", and the script runs without a permission prompt.",{"type":16,"tag":877,"props":1068,"children":1070},{"id":1069},"_5-test-it",[1071],{"type":21,"value":1072},"5. Test it",{"type":16,"tag":17,"props":1074,"children":1075},{},[1076,1078,1084],{"type":21,"value":1077},"Ask something that matches the description (\"write a PR description for this branch\"), then run ",{"type":16,"tag":24,"props":1079,"children":1081},{"className":1080},[],[1082],{"type":21,"value":1083},"/pr-description",{"type":21,"value":1085}," directly. If it doesn't trigger:",{"type":16,"tag":1087,"props":1088,"children":1089},"ul",{},[1090,1103,1108,1121],{"type":16,"tag":120,"props":1091,"children":1092},{},[1093,1095,1101],{"type":21,"value":1094},"ask Claude ",{"type":16,"tag":24,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":21,"value":1100},"What skills are available?",{"type":21,"value":1102}," and check it is listed",{"type":16,"tag":120,"props":1104,"children":1105},{},[1106],{"type":21,"value":1107},"make the description use the words people actually type",{"type":16,"tag":120,"props":1109,"children":1110},{},[1111,1113,1119],{"type":21,"value":1112},"run ",{"type":16,"tag":24,"props":1114,"children":1116},{"className":1115},[],[1117],{"type":21,"value":1118},"claude --debug",{"type":21,"value":1120}," to see YAML parse errors",{"type":16,"tag":120,"props":1122,"children":1123},{},[1124,1125,1131,1133,1138],{"type":21,"value":1112},{"type":16,"tag":24,"props":1126,"children":1128},{"className":1127},[],[1129],{"type":21,"value":1130},"claude plugin validate .claude/skills",{"type":21,"value":1132}," to find ",{"type":16,"tag":24,"props":1134,"children":1136},{"className":1135},[],[1137],{"type":21,"value":29},{"type":21,"value":1139}," files whose frontmatter doesn't parse",{"type":16,"tag":17,"props":1141,"children":1142},{},[1143,1145,1150],{"type":21,"value":1144},"When the YAML is broken, the skill still loads with no metadata. ",{"type":16,"tag":24,"props":1146,"children":1148},{"className":1147},[],[1149],{"type":21,"value":1083},{"type":21,"value":1151}," works, but Claude can't match it on its own.",{"type":16,"tag":75,"props":1153,"children":1155},{"id":1154},"a-real-example-explain-to-customer",[1156],{"type":21,"value":1157},"A real example: explain-to-customer",{"type":16,"tag":17,"props":1159,"children":1160},{},[1161,1167,1169,1174],{"type":16,"tag":41,"props":1162,"children":1165},{"href":1163,"rel":1164},"https://github.com/halitsever/explain-to-customer",[45],[1166],{"type":21,"value":48},{"type":21,"value":1168}," turns a code change, commit range or pull request into a short MP4, a few PNG slides, Mermaid diagrams and a message you can send to a client. Here is the frontmatter of its ",{"type":16,"tag":24,"props":1170,"children":1172},{"className":1171},[],[1173],{"type":21,"value":29},{"type":21,"value":935},{"type":16,"tag":884,"props":1176,"children":1181},{"className":1177,"code":1179,"language":1180,"meta":7},[1178],"language-yaml","---\nname: explain-to-customer\ndescription: Turns a code change into customer-friendly visuals (short MP4 video, annotated images, Mermaid diagrams) in a chosen visual style and saves them where the user picks. Use when the user runs /explain-to-customer or asks to explain or show a change to a customer or client.\nargument-hint: '[commit|range|PR#|\"what changed\"] [video|image|diagram|all] [style=ID] [out=project|cwd|desktop|videos|PATH] [lang=CODE] [audience=technical] [--yes]'\ndisable-model-invocation: true\nallowed-tools:\n  - Bash(git status *)\n  - Bash(git diff *)\n  - Bash(git log *)\n  - Bash(git show *)\n  - Bash(git rev-parse *)\n  - Bash(gh pr view *)\n  - Bash(gh pr diff *)\n  - Bash(node \"${CLAUDE_SKILL_DIR}/scripts/*)\n  - Bash(ffprobe *)\n  - Read(/${CLAUDE_SKILL_DIR}/**)\n---\n","yaml",[1182],{"type":16,"tag":24,"props":1183,"children":1184},{"__ignoreMap":7},[1185],{"type":21,"value":1179},{"type":16,"tag":17,"props":1187,"children":1188},{},[1189,1191,1196,1198,1204,1206,1211,1213,1219,1221,1226,1228,1234,1236,1241],{"type":21,"value":1190},"A run renders video and writes a folder of files, so ",{"type":16,"tag":24,"props":1192,"children":1194},{"className":1193},[],[1195],{"type":21,"value":435},{"type":21,"value":1197}," makes sure it starts only when you type ",{"type":16,"tag":24,"props":1199,"children":1201},{"className":1200},[],[1202],{"type":21,"value":1203},"/explain-to-customer",{"type":21,"value":1205},". The ",{"type":16,"tag":24,"props":1207,"children":1209},{"className":1208},[],[1210],{"type":21,"value":627},{"type":21,"value":1212}," shows the scope, format and ",{"type":16,"tag":24,"props":1214,"children":1216},{"className":1215},[],[1217],{"type":21,"value":1218},"key=value",{"type":21,"value":1220}," options in autocomplete. ",{"type":16,"tag":24,"props":1222,"children":1224},{"className":1223},[],[1225],{"type":21,"value":692},{"type":21,"value":1227}," holds read-only git and ",{"type":16,"tag":24,"props":1229,"children":1231},{"className":1230},[],[1232],{"type":21,"value":1233},"gh",{"type":21,"value":1235}," commands plus the skill's own Node scripts through ",{"type":16,"tag":24,"props":1237,"children":1239},{"className":1238},[],[1240],{"type":21,"value":1049},{"type":21,"value":1242},". The project is only read, so nothing in that list edits, commits or installs anything in it.",{"type":16,"tag":17,"props":1244,"children":1245},{},[1246,1248,1254,1256,1262,1264,1270,1272,1278,1280,1286,1288,1293],{"type":21,"value":1247},"One of the body's ground rules follows from how permission rules match: every bundled script runs as its own bare command, with no ",{"type":16,"tag":24,"props":1249,"children":1251},{"className":1250},[],[1252],{"type":21,"value":1253},"&&",{"type":21,"value":1255},", pipes or ",{"type":16,"tag":24,"props":1257,"children":1259},{"className":1258},[],[1260],{"type":21,"value":1261},"cd",{"type":21,"value":1263}," around it, because the pre-approval rule only matches the bare command. Long guidance lives in ",{"type":16,"tag":24,"props":1265,"children":1267},{"className":1266},[],[1268],{"type":21,"value":1269},"reference/",{"type":21,"value":1271},", styles in ",{"type":16,"tag":24,"props":1273,"children":1275},{"className":1274},[],[1276],{"type":21,"value":1277},"styles/",{"type":21,"value":1279}," and scripts in ",{"type":16,"tag":24,"props":1281,"children":1283},{"className":1282},[],[1284],{"type":21,"value":1285},"scripts/",{"type":21,"value":1287},", so ",{"type":16,"tag":24,"props":1289,"children":1291},{"className":1290},[],[1292],{"type":21,"value":29},{"type":21,"value":1294}," stays a short entry point.",{"type":16,"tag":17,"props":1296,"children":1297},{},[1298,1300,1307],{"type":21,"value":1299},"To install it, use the ",{"type":16,"tag":41,"props":1301,"children":1304},{"href":1302,"rel":1303},"https://github.com/vercel-labs/skills",[45],[1305],{"type":21,"value":1306},"skills",{"type":21,"value":1308}," CLI:",{"type":16,"tag":884,"props":1310,"children":1313},{"className":1311,"code":1312,"language":889,"meta":7},[887],"npx skills add halitsever/explain-to-customer -g -a claude-code\n",[1314],{"type":16,"tag":24,"props":1315,"children":1316},{"__ignoreMap":7},[1317],{"type":21,"value":1312},{"type":16,"tag":17,"props":1319,"children":1320},{},[1321,1323,1328,1330,1335,1337,1344,1346,1352],{"type":21,"value":1322},"Or clone it and symlink the skill folder into ",{"type":16,"tag":24,"props":1324,"children":1326},{"className":1325},[],[1327],{"type":21,"value":335},{"type":21,"value":1329},", then run ",{"type":16,"tag":24,"props":1331,"children":1333},{"className":1332},[],[1334],{"type":21,"value":327},{"type":21,"value":1336}," if that directory didn't exist before. The project's ",{"type":16,"tag":41,"props":1338,"children":1341},{"href":1339,"rel":1340},"https://halitsever.github.io/explain-to-customer/guide/install-claude-code-skill",[45],[1342],{"type":21,"value":1343},"install guide",{"type":21,"value":1345}," covers both ways. I use it at the end of the server setup I described in ",{"type":16,"tag":41,"props":1347,"children":1349},{"href":1348},"/posts/running-claude-code-on-a-server-in-parallel",[1350],{"type":21,"value":1351},"running Claude Code agents in parallel on a server",{"type":21,"value":966},{"type":16,"tag":75,"props":1354,"children":1356},{"id":1355},"when-should-a-skill-become-a-plugin",[1357],{"type":21,"value":1358},"When should a skill become a plugin?",{"type":16,"tag":17,"props":1360,"children":1361},{},[1362,1364,1371],{"type":21,"value":1363},"A skill on its own is enough for most things. A ",{"type":16,"tag":41,"props":1365,"children":1368},{"href":1366,"rel":1367},"https://code.claude.com/docs/en/plugins/overview",[45],[1369],{"type":21,"value":1370},"plugin",{"type":21,"value":1372}," is for when you want to ship several skills, subagents, hooks or MCP servers as one unit, install it in many projects, or publish versions through a marketplace.",{"type":16,"tag":17,"props":1374,"children":1375},{},[1376,1378,1384],{"type":21,"value":1377},"A minimal plugin is a folder with a manifest and a ",{"type":16,"tag":24,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":21,"value":1383},"skills/",{"type":21,"value":1385}," directory:",{"type":16,"tag":884,"props":1387,"children":1390},{"className":1388,"code":1389,"language":21,"meta":7},[1032],"my-plugin/\n├── .claude-plugin/\n│   └── plugin.json\n└── skills/\n    └── review/\n        └── SKILL.md\n",[1391],{"type":16,"tag":24,"props":1392,"children":1393},{"__ignoreMap":7},[1394],{"type":21,"value":1389},{"type":16,"tag":884,"props":1396,"children":1401},{"className":1397,"code":1399,"language":1400,"meta":7},[1398],"language-json","{\n  \"name\": \"my-plugin\",\n  \"description\": \"Team review workflow\",\n  \"version\": \"1.0.0\"\n}\n","json",[1402],{"type":16,"tag":24,"props":1403,"children":1404},{"__ignoreMap":7},[1405],{"type":21,"value":1399},{"type":16,"tag":17,"props":1407,"children":1408},{},[1409,1411,1417,1419,1425,1427,1433,1435,1441],{"type":21,"value":1410},"That skill runs as ",{"type":16,"tag":24,"props":1412,"children":1414},{"className":1413},[],[1415],{"type":21,"value":1416},"/my-plugin:review",{"type":21,"value":1418},". While developing, load the folder for one session with ",{"type":16,"tag":24,"props":1420,"children":1422},{"className":1421},[],[1423],{"type":21,"value":1424},"claude --plugin-dir ./my-plugin",{"type":21,"value":1426}," and check it with ",{"type":16,"tag":24,"props":1428,"children":1430},{"className":1429},[],[1431],{"type":21,"value":1432},"claude plugin validate ./my-plugin",{"type":21,"value":1434},". Published plugins install with ",{"type":16,"tag":24,"props":1436,"children":1438},{"className":1437},[],[1439],{"type":21,"value":1440},"/plugin install \u003Cplugin>@\u003Cmarketplace>",{"type":21,"value":1442},". An enabled plugin's skill descriptions sit in context on every turn, even when nothing from it runs.",{"type":16,"tag":75,"props":1444,"children":1446},{"id":1445},"claude-code-best-practices-for-skills",[1447],{"type":21,"value":1448},"Claude Code best practices for skills",{"type":16,"tag":17,"props":1450,"children":1451},{},[1452,1454,1461],{"type":21,"value":1453},"These come from Anthropic's ",{"type":16,"tag":41,"props":1455,"children":1458},{"href":1456,"rel":1457},"https://code.claude.com/docs/en/best-practices",[45],[1459],{"type":21,"value":1460},"Claude Code best practices",{"type":21,"value":1462}," page and the skills docs.",{"type":16,"tag":1087,"props":1464,"children":1465},{},[1466,1478,1483,1488,1493,1513],{"type":16,"tag":120,"props":1467,"children":1468},{},[1469,1471,1476],{"type":21,"value":1470},"Put procedures in skills and facts in ",{"type":16,"tag":24,"props":1472,"children":1474},{"className":1473},[],[1475],{"type":21,"value":105},{"type":21,"value":1477},". A release checklist belongs in a skill, so it loads only when you release.",{"type":16,"tag":120,"props":1479,"children":1480},{},[1481],{"type":21,"value":1482},"Only write down what Claude can't find on its own. Don't explain what the codebase already shows.",{"type":16,"tag":120,"props":1484,"children":1485},{},[1486],{"type":21,"value":1487},"Keep the body short. Once loaded, every line stays in context across turns.",{"type":16,"tag":120,"props":1489,"children":1490},{},[1491],{"type":21,"value":1492},"Use a hook for a rule that must always hold. Claude reads a skill and usually follows it, but Claude Code runs a hook every time its event fires.",{"type":16,"tag":120,"props":1494,"children":1495},{},[1496,1498,1503,1505,1511],{"type":21,"value":1497},"Review ",{"type":16,"tag":24,"props":1499,"children":1501},{"className":1500},[],[1502],{"type":21,"value":692},{"type":21,"value":1504}," in skills you didn't write. A project skill's grant applies even in a ",{"type":16,"tag":24,"props":1506,"children":1508},{"className":1507},[],[1509],{"type":21,"value":1510},"claude -p",{"type":21,"value":1512}," run in a folder you never trusted.",{"type":16,"tag":120,"props":1514,"children":1515},{},[1516],{"type":21,"value":1517},"Install skills only from sources you trust. Anthropic's overview warns that a malicious skill can make Claude run code unrelated to its stated purpose.",{"type":16,"tag":17,"props":1519,"children":1520},{},[1521,1523,1529],{"type":21,"value":1522},"If you'd like help building skills or Claude Code workflows for your team, my ",{"type":16,"tag":41,"props":1524,"children":1526},{"href":1525},"/hire",[1527],{"type":21,"value":1528},"hire page",{"type":21,"value":1530}," has the details.",{"type":16,"tag":75,"props":1532,"children":1534},{"id":1533},"faq",[1535],{"type":21,"value":1536},"FAQ",{"type":16,"tag":877,"props":1538,"children":1540},{"id":1539},"what-is-the-difference-between-a-skill-and-a-slash-command",[1541],{"type":21,"value":1542},"What is the difference between a skill and a slash command?",{"type":16,"tag":17,"props":1544,"children":1545},{},[1546,1548,1554,1556,1562,1564,1570],{"type":21,"value":1547},"Custom commands were merged into skills. A file in ",{"type":16,"tag":24,"props":1549,"children":1551},{"className":1550},[],[1552],{"type":21,"value":1553},".claude/commands/deploy.md",{"type":21,"value":1555}," and a skill at ",{"type":16,"tag":24,"props":1557,"children":1559},{"className":1558},[],[1560],{"type":21,"value":1561},".claude/skills/deploy/SKILL.md",{"type":21,"value":1563}," both give you ",{"type":16,"tag":24,"props":1565,"children":1567},{"className":1566},[],[1568],{"type":21,"value":1569},"/deploy",{"type":21,"value":1571},". The skill version can also hold supporting files, and it wins if both exist.",{"type":16,"tag":877,"props":1573,"children":1575},{"id":1574},"why-doesnt-claude-use-my-skill-automatically",[1576],{"type":21,"value":1577},"Why doesn't Claude use my skill automatically?",{"type":16,"tag":17,"props":1579,"children":1580},{},[1581,1583,1588],{"type":21,"value":1582},"Usually the description doesn't match how you ask, the YAML doesn't parse, or ",{"type":16,"tag":24,"props":1584,"children":1586},{"className":1585},[],[1587],{"type":21,"value":435},{"type":21,"value":1589}," is set. The checks in step 5 find each of these.",{"type":16,"tag":877,"props":1591,"children":1593},{"id":1592},"can-i-use-claude-code-skills-in-scripts",[1594],{"type":21,"value":1595},"Can I use Claude Code skills in scripts?",{"type":16,"tag":17,"props":1597,"children":1598},{},[1599,1601,1606,1608,1614],{"type":21,"value":1600},"Yes. In non-interactive mode you put ",{"type":16,"tag":24,"props":1602,"children":1604},{"className":1603},[],[1605],{"type":21,"value":37},{"type":21,"value":1607}," in the prompt string and Claude Code expands it before the run. I cover that mode in ",{"type":16,"tag":41,"props":1609,"children":1611},{"href":1610},"/posts/claude-code-headless",[1612],{"type":21,"value":1613},"Claude Code headless mode",{"type":21,"value":966},{"type":16,"tag":877,"props":1616,"children":1618},{"id":1617},"do-claude-code-skills-work-on-claudeai",[1619],{"type":21,"value":1620},"Do Claude Code skills work on claude.ai?",{"type":16,"tag":17,"props":1622,"children":1623},{},[1624,1626,1631],{"type":21,"value":1625},"The format is shared, but only with the six spec fields listed above, and Claude Code-only features such as ",{"type":16,"tag":24,"props":1627,"children":1629},{"className":1628},[],[1630],{"type":21,"value":957},{"type":21,"value":1632}," injection don't run there.",{"title":7,"searchDepth":1634,"depth":1634,"links":1635},2,[1636,1637,1638,1639,1640,1648,1649,1650,1651],{"id":77,"depth":1634,"text":80},{"id":149,"depth":1634,"text":152},{"id":340,"depth":1634,"text":343},{"id":499,"depth":1634,"text":502},{"id":867,"depth":1634,"text":870,"children":1641},[1642,1644,1645,1646,1647],{"id":879,"depth":1643,"text":882},3,{"id":908,"depth":1643,"text":911},{"id":919,"depth":1643,"text":922},{"id":1013,"depth":1643,"text":1016},{"id":1069,"depth":1643,"text":1072},{"id":1154,"depth":1634,"text":1157},{"id":1355,"depth":1634,"text":1358},{"id":1445,"depth":1634,"text":1448},{"id":1533,"depth":1634,"text":1536,"children":1652},[1653,1654,1655,1656],{"id":1539,"depth":1643,"text":1542},{"id":1574,"depth":1643,"text":1577},{"id":1592,"depth":1643,"text":1595},{"id":1617,"depth":1643,"text":1620},"content:posts:claude-code-skills.md","content","posts/claude-code-skills.md","md",{"loc":4},[1663,1667,1671,1675,1678,1682,1686,1690,1694,1698,1702,1706,1710,1714,1718,1722,1726,1730,1733,1737,1741,1745,1750,1754,1758],{"_path":1664,"title":1665,"description":1666,"lang":169},"/posts/api-nedir","API nedir? REST API, HTTP istekleri ve durum kodları","API nedir, ne işe yarar? curl ile gerçek bir API isteği, REST API nedir, HTTP metodları, durum kodları ve API'lerde kimlik doğrulama, sade bir dille.",{"_path":1668,"title":1669,"description":1670,"lang":169},"/posts/backend-nedir","Backend nedir, backend developer ne iş yapar? Frontend ile farkı","Backend nedir, backend developer ne iş yapar? Sunucu, API ve veritabanı tarafını, frontend ile farkını ve küçük bir NestJS örneğini anlatıyorum.",{"_path":1672,"title":1673,"description":1674,"lang":169},"/posts/bursa-gunubirlik-gezi-mudanya-koza-han-golyazi","Bursa günübirlik gezi: Mudanya, Koza Han, İskender ve Gölyazı","İstanbul'dan Bursa'ya günübirlik gezi: Mudanya'da kahvaltı, Koza Han, Mavi Dükkan'da Bursa iskender ve Gölyazı'daki 725 yıllık Ağlayan Çınar.",{"_path":1610,"title":1676,"description":1677},"Claude Code headless mode: claude -p in scripts and CI","How Claude Code headless mode works: claude -p, text and JSON output, permission flags, bare mode, auth tokens and running it in scripts and GitHub Actions.",{"_path":1679,"title":1680,"description":1681,"lang":169},"/posts/claude-code-nedir","Claude Code nedir, nasıl kurulur ve kullanılır?","Claude Code nedir? Anthropic'in kodlama aracının kurulumu, giriş, temel komutlar, CLAUDE.md, izin modları ve sunucuda paralel kullanımı, örneklerle.",{"_path":1683,"title":1684,"description":1685,"lang":169},"/posts/docker-nedir","Docker nedir? Image, container, kurulum ve Docker Compose","Docker nedir, ne işe yarar? Image, container, volume ve network kavramları, Ubuntu'ya Docker kurulumu ve küçük bir docker-compose.yml örneği.",{"_path":1687,"title":1688,"description":1689,"lang":169},"/posts/full-stack-developer-nedir","Full stack developer nedir, ne iş yapar, nasıl olunur?","Full stack developer nedir, ne iş yapar? Frontend, backend, veritabanı ve deploy katmanları, gerçek bir stack, 2026 maaş verisi ve nasıl olunacağı.",{"_path":1691,"title":1692,"description":1693,"lang":169},"/posts/istanbul-yazilim-sirketleri","İstanbul yazılım şirketleri: nasıl seçilir ve kimler var? (2026)","İstanbul yazılım şirketleri arasında nasıl seçim yapılır? Sorulacak sorular, sözleşme ve kod sahipliği, uyarı işaretleri ve bilinen şirketlerden bir liste.",{"_path":1695,"title":1696,"description":1697},"/posts/nestjs-vs-express","NestJS vs Express: the same endpoint in both, and when to pick which","NestJS vs Express from a NestJS developer: the same API in both, testing, performance numbers from the official docs, and when to pick each.",{"_path":1699,"title":1700,"description":1701,"lang":169},"/posts/node-js-nedir","Node.js nedir? Event loop, npm ve ilk HTTP sunucusu","Node.js nedir, ne işe yarar? Event loop'un sade bir anlatımı, npm, sıfırdan bir HTTP sunucusu ve Node.js'in diğer backend seçenekleri arasındaki yeri.",{"_path":1703,"title":1704,"description":1705},"/posts/nuxt-seo","Nuxt SEO: the setup I use on this site, with the real config","A practical Nuxt SEO guide from halit.org: sitemap, robots, schema.org, useSeoMeta, real 404s, prerendering, hreflang and the nofollow default in Nuxt Content.",{"_path":1707,"title":1708,"description":1709},"/posts/nuxt-vs-next","Nuxt vs Next: an honest comparison from someone who ships Nuxt","Nuxt vs Next compared on Nuxt 4.6 and Next.js 16: rendering modes, routing, data fetching, ecosystem and deployment, with code for the same page in both.",{"_path":1711,"title":1712,"description":1713,"lang":169},"/posts/prometheus-grafana-nedir","Prometheus nedir, Grafana nedir? node_exporter ile sunucu izleme","Prometheus nedir, Grafana nedir ve birlikte nasıl çalışırlar? Metrikler, exporter'lar, node_exporter, PromQL örnekleri ve Docker Compose ile kurulum.",{"_path":1715,"title":1716,"description":1717},"/posts/teleparty-alternative","Teleparty alternative: free ways to watch together online","Looking for a Teleparty alternative? An honest look at Watchbear, Discord Watch Together and Watch2Gether for watching YouTube and Netflix with friends.",{"_path":1719,"title":1720,"description":1721,"lang":169},"/posts/typescript-nedir","TypeScript nedir? JavaScript'e ne ekler, tsconfig nasıl ayarlanır?","TypeScript nedir, JavaScript'ten farkı ne? Tipler, union, generic ve narrowing örnekleri, tsconfig.json'un temel ayarları ve Node.js ile kullanımı.",{"_path":1723,"title":1724,"description":1725,"lang":169},"/posts/yazilimci-maaslari-2026","Yazılımcı maaşları 2026: kıdem, pozisyon, şehir ve çalışma düzenine göre","Yazılımcı maaşları 2026: 5.002 kişilik anketin ham verisinden hesapladığım junior, middle, senior, pozisyon, şehir ve remote maaş ortancaları.",{"_path":1727,"title":1728,"description":1729,"lang":169},"/posts/yazilimci-nasil-olunur","Yazılımcı nasıl olunur? Yazılım öğrenmek için pratik bir yol","Yazılımcı nasıl olunur, yazılım öğrenmeye nereden başlanır? 2012'de forumlarla başlayıp 2020'den beri profesyonel çalışan bir yazılımcının pratik planı.",{"_path":1348,"title":1731,"description":1732},"How I run multiple Claude Code agents in parallel on a server","My Claude Code setup: an Ubuntu server set up with claude-code-vps, parallel agents in a tmux grid with claudegrid, and the HaltOS desktop on top.",{"_path":1734,"title":1735,"description":1736},"/posts/small-web-tools-json-to-excel-steam-deck-watchbear","Small web tools I made: JSON to Excel, Steam Deck web apps, Watchbear","A JSON to Excel converter, a generator that puts any website in Steam Deck Game Mode, and Watchbear for watching videos in sync with friends.",{"_path":1738,"title":1739,"description":1740,"lang":169},"/posts/udf-dosyasi-nasil-acilir-pdf-word-cevirme","UDF dosyası nasıl açılır, PDF'ye ve Word'e nasıl çevrilir?","UYAP'ın UDF dosyasını program kurmadan tarayıcıda açmak, PDF'ye ve Word'e çevirmek, Word ve PDF'den UDF hazırlamak. Her aracın neyi koruyup neyi kaybettiğiyle birlikte.",{"_path":1742,"title":1743,"description":1744},"/posts/i-built-a-free-chrome-extension-to-watch-any-video-in-sync-with-friends","I built a free Chrome extension to watch any video in sync with friends","Watchbear is my free Chrome extension to watch YouTube together with friends: start a room, share the link, and play, pause and seek stay in sync.",{"_path":1746,"title":1747,"description":1748,"lang":1749},"/posts/a-short-trip-to-bursa","A day trip to Bursa: Mudanya, Koza Han, Iskender and Gölyazı","A day trip to Bursa via the Osmangazi Bridge, breakfast in Mudanya, Koza Han, Mavi Dükkan Iskender, and a peaceful visit to Gölyazı.","en",{"_path":1751,"title":1752,"description":1753},"/posts/embedding-metabase-dashboard-on-nuxt-app","Embedding a Metabase dashboard in a Nuxt 3 app","Metabase embedding in Nuxt 3: sign the embed JWT in a server route, lock parameters per user, set token expiry and theme the embedded dashboard.",{"_path":1755,"title":1756,"description":1757},"/posts/grafana-deep-dive","Grafana Docker Compose setup with Prometheus and node_exporter","Monitor a server with Grafana in Docker: a docker-compose.yml for Grafana, Prometheus and node_exporter, the scrape config, and a ready-made dashboard.",{"_path":1759,"title":1760,"description":1761},"/posts/deploy-express-app-on-vercel","Deploying an Express.js application on Vercel","How to deploy an Express app on Vercel: the zero-config way, the older vercel.json setup, environment variables, logs and serverless limits.",null,1795295806529]