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=1794494598; b=yvHYbAnDqpBxrxwMz8UoRfOhjQAtHF42pfVrLFFcUb4zBYFaKRLXoqINn3dnaKdxcMgB 06IZnlJWXszob+hQPky3ka/EuNgFKDgdQtHh5aW5jHI9fT5rE/Uql3R3dKPyQmYzRzBIP zDjkgtu8S4k3z0XV+byTRbfXPYQAnW1at6Ex8aUEM2pmBbpSAU8YUIhA155OD3KflRLSf xdYARK7yNMulsEXO7v0zGYIHVe8GWGJzmP+TepHP2Aav6UQvdW5pJ7gd7nnp17LGv1WuH RtKz6ykKjPH87hBHlz72lYl+M76zeQ2ujJRZTvfC6jA/XtJAS3YmHFYa6xNg/DJ593Q== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794494598; 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=M9vPygYp7U6CccHPDY6N3dzcJLs7/OIE0oif+de+3x5masPlaJfB+Cu7cKm8+8XE8vhk 6XZbsdlZKM11DUQ/i/vhcNlOZT/88pndwBTR4DbacEKyGcLxVBHG22vU3XnVYiCOlVIH4 oVHgsXx62DCxSVg2+fR/USt813yEUc2+81anqy9OVPmBNgjD+4iOy7HxeAbGmrLfY2cmp IyfxTAyQGvq91r2hjKwaWx6n1DLaF0nZiH099yckNWk5w8viOGagFIs7v2Qq3eLq1pDZe +o6fT3AW0gF/sB1HZymvRlPgp445sGXv8p4cbslSmvai5m2r62RT5Ql0m2S33ewioCA== 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 54E79606A321 for ; Thu, 12 Nov 2026 14:43:18 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 54E79606A321 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: linux-doc@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