From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=18.9.28.11 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794494601; b=R45hTjDP553bxwm1e+OVnxHbk12S1usjqrquLHN+WLIb7e8Z6WYmdhX2m83CQuCiRq7t wof8+ZqiUuD/IEAqb+6SKy4aMc2IT1+uVw6wwBuQlk2CPb97xl/B8R8t8/XcPqMozxb2K UEZtJkZGF7XMSE8NJIOdPsAwHannBmRwdBWhMnoIoIt0d6T5kYwb1xjDviiKzSLBGbw47 QoX0x9g7N6YaQtOr3AcitQLbs5y0faRZr0nqiC25k/9kG6kORcqgk9nYMAEUpGenJyGzW 2Q7ZcZhrRTJ0n+AqepU+H+/OzRnrY30c6tXIHXFNVgdbTOvFhD6h4PIWiZuILEWDJEg== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794494601; h=DMARC-Filter:Received:DKIM-Signature:Received:Date:From:To:Cc: Subject:Message-ID:References:MIME-Version:Content-Type: Content-Disposition:In-Reply-To; bh=doRR2hlsDqY4KYCxE3inoPjG+grnCS2sG965WCAyZas=; b=HzwIe6LuU8Sd0yCla0FTtiQ3TSK7M9OQIlwui58+uc3mchyZ1kLoQ9mWhZXzIsunbR8c 4YbvNn2pKbhDOw5XAazyBquMHkomurV9bFwsBmqiMwz/OALfzA7HtOaY5wXcP/xhE9HZd CCWvoiXOddEwUDTXGOCWP1BPxn9GSjy9OIocoNVRFVJAPahgkH3hrUYOIny5/3iZCTgEA m+E+DLmWB5xG3g+Z+aSTd/lr1XHcxzBTSm/TDb4W4tInl05YV4cxoSL9KRD9SYWk7hMK6 6HFjy1JxtUE8afpLF9pUvWpFkgDrBR0z3bMMQChofwFrBGXrFgYvtSQZfEEpuBm8A6Q== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=mit.edu; spf=pass smtp.mailfrom=mit.edu; dkim=pass header.d=mit.edu header.i=@mit.edu header.a=rsa-sha256 header.s=outgoing header.b=PCpUqHRW; arc=none smtp.remote-ip=18.9.28.11 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A9CB3606A335 for ; Thu, 12 Nov 2026 14:43:20 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org A9CB3606A335 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=mit.edu Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=mit.edu Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=mit.edu header.i=@mit.edu header.a=rsa-sha256 header.s=outgoing header.b=PCpUqHRW Received: from macsyma.thunk.org (pool-173-48-111-191.bstnma.fios.verizon.net [173.48.111.191]) (authenticated bits=0) (User authenticated as tytso@ATHENA.MIT.EDU) by outgoing.mit.edu (8.14.7/8.12.4) with ESMTP id 6ACEgZrS029468 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 12 Nov 2026 09:42:36 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mit.edu; s=outgoing; t=1794494561; bh=doRR2hlsDqY4KYCxE3inoPjG+grnCS2sG965WCAyZas=; h=Date:From:Subject:Message-ID:MIME-Version:Content-Type; b=PCpUqHRWzITexZeciyh8kmVbkihYGX8mwUkz4BDsbPPLX+qgXZSgK0siPFYDtsNvw vhi19YCkVdpN2IOIuCQkUbTABBSJH34jKgUk1v7pcRSM1aF+AI/t36ClaWCrfW2JJN FcvflnJ9GzeSyh+wHskHLh8VisHyED/GCv1zGigO8l7ebgLy4JiNG3DwOYnQyWrVta EQI9zCjNPdNU2JePDhpFJerpbV/T9UDaDhfs+O06B95xIv8USzHrU41itNr13pVwFh S4khQLaNAECVY8NIwKjwYoV0mGOMtac6jtKQmU3og6QNRrEW6ISyYhUHAEkjw/6H5q +6t7Ei0rd0G3g== Received: by macsyma.thunk.org (Postfix, from userid 15806) id CC8FE26E540E; Thu, 12 Nov 2026 09:42:35 -0500 (EST) Date: Thu, 12 Nov 2026 09:42:35 -0500 From: "Theodore Tso" To: Krzysztof Kozlowski Cc: workflows@vger.kernel.org, ksummit@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet , Shuah Khan , Randy Dunlap , Mark Brown , Laurent Pinchart , Greg Kroah-Hartman , Leon Romanovsky , Konstantin Ryabitsev , Thorsten Leemhuis , "Michael S. Tsirkin" , Kees Cook , Geert Uytterhoeven , Dan Carpenter , Miguel Ojeda , Alexei Starovoitov , Julia Lawall , SJ Park , Bradley Morgan , Sasha Levin , stable@vger.kernel.org Subject: Re: [PATCH v5 0/6] agents: add skills for Fixes tags, stable tags, similar bugs, and commit messages Message-ID: References: <20261111225940.1573565-1-tytso@mit.edu> <9c5f5976-ebed-48f3-94ab-1121231af6e1@kernel.org> <31a56051-bd63-4a39-9cad-2c9afcd98340@kernel.org> X-Mailing-List: workflows@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <31a56051-bd63-4a39-9cad-2c9afcd98340@kernel.org> On Thu, Nov 12, 2026 at 02:49:09PM -0500, Krzysztof Kozlowski wrote: > > Specification is also documentation, just like for example specification > for our ABI. It's also located in Documentation directory. Source and header files can also contain documentation. But we don't put them in the Documentation directory because they do not contain *exclusively* documentation. If the complaint is that it is visible when we run "ls", one compromise might be to put the skills in .agents/skills. This is a cross-harness standard which is supported by some code harneses (Google Antigravity, Github Copilot, etc.). Some harneses (including Claude Code, Opencode) don't, but people who use these harneses can solve it by installing their own symlink from .claude/skills, .opencode/skills, etc. to the right place. Cheers, - Ted