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=1794494599; b=IW2NJ+pxjQmfcn1MQrHrsKD8+wTYltmkh8s/18rsCB87+odRFqEC7RkYU60dQvPGRh5f 7rhx0Rqp+ZoRRIWAVtdrneRIwyfqvgBat/vQxcEEsUXVnB8GXAKc9/yyfIHQ6CI5X+PBa PIbXjMkkmXoIae0DW3gyV/AKLhlFeo+cvm9uQbhjaIFFC/0eIjs423v5nkClMIAX/S66G Ip8gnBetMguwiiMs/7idApuLKHmtTq78fLBqTonGfXEK1YIyMDZff0hQbnPf97eD3NjYB SEXYNaLb40YXI2Lav0w2snVkOH31cGJJ17xqySUYDjNh7nQGu6RRWl6QUxvo9OevrjA== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794494599; 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=BxnwZNBMBFEaLRR8+6EpVwRg0lpllcfKSPkppzj5OrrTO5nGwtwAhKv+aQo1sRGOwG9C fD52Pd9whncvjT2QruRrpJrz0ui89snWA/aHWk5ejNqX97iBMzY7oNsRC/OwdG+NuIpl6 cSNnM+Fg8vgAG4uGn7dIBTM3oe8zEYalSUhuRsBlheAjDY/Z8HdcFhAGNHkCcUg4n9gw2 AdC0m+LFg0f+lVYIDQGJVxLUKdc6nmD+EBHM7VwhGY9Z7Pr0FjbtreI2v5Wxetb+gRUOf qjrsQ5Bu18eAmCUwoSPRyMdt87FwUbdBWz7Uk9rysF448VROeyglKhgGs/vMaQfr/Cg== 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 1DDA2606A330 for ; Thu, 12 Nov 2026 14:43:19 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 1DDA2606A330 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-kernel@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