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=1794494588; b=xPMLZvy5Z70GafED3HYLQKPj9LToamQH71OKjCzAzeG9kHBRMgzt0rXBquGGYrcVzDQa d18+wzy9qzbY0KHTAnZ4XfyY4vTy6jHJ32Jwn8qk3OXD+dzdrw//QuAwSgCCXb77uAr/x 8T6L7Hn/zV+MEwoTJdytqUY8O/d+Vjzi5BrxoDl+CvJuXKx7dOm7LtyIPKE+3S/ZacAQq Hd+W3G2bHmMSiDRh80JWFkkccNA+DR8Mcf1XLa97Sr2nBqT5JX1Zg8PgEUm6QUdDQpoJX lajqGUE3mHO3DpYR31vBM8jhKRKFvv24qRLrMhv9acBKw8Uv1Rx902V0oVesm6fYf7g== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794494588; 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=2BFMlnN4DcaumIXMUdK55sPif6VxJUiiqL9x8C0Yj6SSmQD+kDjtHqN9BRX83BtbE9GI N6qvWvIZmArTgq+SazEezjZ2u/BqfPTBwNL71j5dn4Fuiv5GeVXlLiULC3Or+utxH/96b SK2LFLCyFqz/1ANEUhbfP12J0cf1LC4upPLw2hgMtNSNnFGm0t4gEodFJ+xho4m+muWgs nB3BAI5NeCG3IPKk8lBt4s/aAXByGiYjIyLC8vi8PHqtuc0mtfLuUa0FHo926jueN+UG8 9vPvTAAXbzFjFn6YfqC//WOp+MryaI4ScvZV1+btytUL+qvEp7K8BdoXuZql1nBAqWA== 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 DAAE2606A327 for ; Thu, 12 Nov 2026 14:43:07 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org DAAE2606A327 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, unprotected) 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: ksummit@lists.linux.dev 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